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1. Introduction 

"What is Emacs? It is a tree falling in the 
forest with no one to hear it. It is a beautiful 
flower that smells awfiil." 

This manual attempts to describe the Unix implementation of Emacs, an extensible display editor. It is an 
editor in that it is primaniy used for typing in and modifying documents, programs, or anything else that is 
represented as text. It uses a display to interact with the user, always keeping an accurate representation of 
what is happening visible on the screen that changes in step with the changes made to the document. The 
feature that distinguishes E.MACS from most other editors is its extensibility, tJiat is, a user of Emacs can 
dynamically change EmacS to suit his own tastes and needs. 

Calling this editor Emacs is rather presumptuous and even dangerous. There are two major editors called 
Emacs. The first was written at MIT for their ITS systems as an extension to TECO. This editor is the 
spiritual father of all the EMACS-like editors; it's principal author was Richard Stallman. ITie other was also 
written at MIT, but it was written in MacLisp for Multics by Bernie Grccnbcrg. Iliis editor picks up where 
ITS Emacs leaves otTin terms of its extension facilities. Unix EmacS was called Emacs in the hope that the 
cries of outrage would be enough to goad the autlior and others to bring it up to the standards of what has 
come before. 

This manual is organized in a rather haphazard manner. The first several sections were written hastily in an 
attempt to provide a general introduction to tlie commands in E.MACS and to try to show the metliod in the 
madness that is the Emacs command structure. Section 20 (page 32) contains a complete but concise 
description of all the commands and is in alphabetical order based on the name of the command. Preceding 
sections generally do not give a complete description of each command. ratJicr they give either tlie name of 
the command or the key to which the command is conventionally bound. Section 22 (page 69) lists for each 
key the command to which it is conventionally bound. The options which may be set with tlie set command 



2= The Screen 

Emacs divides a screen into several areas called windows, at the bottom of the screen there is a one line area 
that is used for messages and questions from Emacs. Most people will only be using one window, at least 
until they become more familiar with Emacs. A window is displayed as a set of lines, at the bottom of each 
window is its mode line (For more information on mode lines see section 16, page 18). The lines above the 
mode line contain an image of the text you are editing in the region around dot (or point). Dot is the 
reference around which editing takes place. Dot is a pointer which points at a position between two 
characters. On the screen, the cursor will be positioned on the character that immcdintly follows dot. When 
characters arc inserted, tliey are inserted at the position where dot points; commands exist tliat delete 
characters both to the left and to tlie right of dot. The text on the screen always rcficcts they way tliat the text 
looks now. 
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3. Input Conventions 

Throughout this manual, characters which are used as commands are printed in bold face: X. They will 
sometimes have a control prefix which is printed as an uparrow character: tX is control-X and is typed by 
holding down the control {often labeled Ctrl on the top of the key) and simultaneously striking X. Some will 
have an escape (sometimes called meta) prefix which is usually printed thus: ESC-X and typed by sU'iking the 
escape key (often labeled esc) then X. And some will have a tX prefix which is printed tXX which is typed by 
holding down the control key, striking X, releasing the control key then striking X again. 

For example, ESC-t J is typed by striking ESC then holding down the control key and striking J. 

4. Invoking Emacs 

Emacs is invoked as a Unix command by typing 
emacs files 

to tlie Shell (the Unix command interpreter). RmacS will start up, editing the named files. You will probably 
only want to name one file. If you don't specify any names, Emacs will use the same names tliat it was given 
the last time that it was invoked. Gory details on the invocation of Emacs can be found in section 12.4, page 
14. 



5. Basic Commands 

Normally each character you type is interpreted individually by EmaCS as a command. The instant you 
type a character the command it represents is performed immcdiatly. 

All of the normal printing characters when struck just insert themselves into the buffer at dot. 

To move dot tlicre arc several simple commands. tF moves dot forward one character. tB moves it 
backward one character. tN moves dot to the same column on die next line, tP moves it to the same column 
on the previous line. 

String searches may be used to move dot by using the tS command to search in the forward direction and 
tR to search in the reverse direction. 

Deletions may be performed using tH (backspace) to delete the character to the left of dot and tD to delete 
the character to tlic right of dot. 

The following table summarizes all of the motion and deletion commands. 



Direction 
Move Delete 



Units of Motion 


Left 


Rieht 


Left 


Right 


Characters 


tB 


tF 


til 


tD 


Words 


ESC-B 


ESC-F 


ESC-H 


F5C-D 


Intra line 


tA 


tE 




tK 


Inter line 


tP 


tN 
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6. Unbound Commands 

Even Lhn!!£?h the nnrnhpr rsf rhnrnrtfrc avail'ohl.i tr-. -.ico fXi- Ciha.'-p .--.-.rr.r>,.-....^., :., I »i 
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commands tlian characters. You probably wouldn't want to bind them all to keys even if you could. Each 
command has a long name and by that long name may be bound to a key. For example, tF is normally 
bound to the command named yc?nvari/-c/iarac/er which moves dot forward one character. 

uiere are many commands that are not normally bound to keys. Tliese must be executed with the ESC-X 
command or by binding them to a key (via the bind-to-key command). Heaven help the twit who rebinds 
ESC-X. 

The ESC-X command will print ": " on the last line of the display and expect you to type in Hie name of a 
command. Space and ESC characters may be struck to invoke Tenex style command completion (ie. you type 
in the first pan of the command, hit the space bar, and Emacs will fill in the rest for you - it will complain if 
it can't figure out what you're u-ying to say). If die command requires arguments, they will also be prompted 
for on the bottom line. 



7. Getting Help 

Emacs has many commands that let you ask Emacs for help about how to use Emacs. The simplest one is 
ESC-? (apropos) which asks you for a keyword and then displays a list of those commands whose full name 
contains the keyword as a substring. For example, to find out which commands are available for dealing with 
windows, type ESC-?, Emacs will ask "Keyword:" and you reply "window". A list like the following 
appears: 



beginning-of- window 


ESC-. 


delcie-othcr-windows 


tXl 


delete-window 


tXD 


end-of-window 


ESC-. 


cniargC" window 
line-to-top-of-window 


t.XZ 
ESC-! 


next-window 


tXN 


page-ncxt-window 


ESC-tV 


previous-window 


tXP 


shrinic-window 


tXtZ 


split-current-window 


tX2 



To get detailed information about some command, the describe-command command can be used. It asks 
for the name of a command, then displays the long documentation for it from the manual. For example, if 
you wanted more information about the shrink-window command, just type 
"ESC-Xdescribc-command shrink-window" and Emacs will reply: 
shrink-window tXtZ 

Makes Ihe current window one line shorter, and Ihc window below 
(or the one above if there Ls no window below) one line taller. 
Can't be used if there is only one window on the screen. 

If you want to find out what command is bound to a particular key, describe- key will do it for you. 
Describe-bindings can be used to make a "wall chart" description of the key bindings in the currently mnning 
Emacs, taking into account all of tlic bindings you have made. 
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8. Buffers and Windows 

There are two fundamental objects in EmacS, buffers and windows. A buffer is a chunk of text that can be 
edited, it is often the body of a file. A window is a region on the screen through which a bufTer may be 
viewed. A window looks at one buffer, but a buffer may be on view in several windows. It is often handy to 
have two windows looking at the same buffer so that you can be looking at two seperatc parts of the same file, 
for example, a set of declarations and a piece of code that uses those declarations. Similarly, it is often handy 
to have two different buffers on view in two windows. 

Tlie commands which deal with windows and buffers are: beginning-of-window (ESC-,), dclete-other- 
windows (tXl), deletc-rcgion-to-buffcr (ESC-tVV), delctc-window (tXD), end-of-window (ESC-.), enlarge- 
window (tXZ), line-to-top-of-window (ESC-!), list-buffers (tXtB), next-window (tXN), page-ncxt-window 
(ESC-tV), previous-window (tXP), shrink-window (tXtZ), split-currcnt-window (tX2), switch-to-buffcr 
(tXB), usc-old-buffer (tXtO) and yank-buffer (ESC-tY). See the command description section for more 
details on each of these. 



9. Compiling programs 

One of die most powerful features of Unix EmaCS is tlie facility provided for compiling programs and 
coping with error messages from the compilers. It essential that you understand tlie standard Unix program 
make (even if you don't use E.MACS). This program takes a database (a makefile) that describes the 
relationships among files and how to regenerate (recompile) them. If you have a program that is made up of 
many little pieces that have to be individually compiled and carefully crafted together into a single execuLible 
file, make cm make your life orders of magnitude easier; it will automatically recompile only those pieces that 
need to be recompiled and put them together. Emacs has a set of commands that gracefully interact witii this 
facility. 

The tXtE {execute) command writes all modified buffers and executes the make program: The output of 
make will be placed into a buffer called Error log which will be visible in some window on the screen. As soon 
as make has finished Emacs parses all of its output to find all the error messages and figure out tlie files and 
lines referred to. All of tliis information is squirreled away for later use by the tX^N command. 

The tXtN {next) command takes the next error message from the set prepared by tXtE and does three 
things with it: 

• Makes the message itself visible at the top of a window. The buffer will be named Error log. 

• Does a v(^/7 (sec the tXtV command) on the file in which the error occurred. 

• Sets dot to the beginning of the line where die compiler saw the error. This setting of dot takes 
into account changes to the file that may have been made since the compilation was attempted. 
Emacs perfectly compensates for any changes that may have been made and always positions the 
text on the correct line (well, correct as far as the compiler was concerned; the compiler itself may 
have been a trifle confused about where the error occurred) 

If you've seen all the error messages tXtN will say so and do noticing else. 
So, the general scenario for dealing with programs is: 
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• Build a make database to describe how your program is to be compiled. 

• Compile your program from within Emacs by typing tXtE. 

• If there were errors, step through tlicm by typing tX*N, correcting the error, and typing tXtN to 
get the next 

• When you run out of error messages, type tXtE to try the compilation again. 

• When you finally manage to get your beast to compile without any errors, type tC to say goodbye 
to Emacs. 

• You'll probably want to use sdb, the symbolic debugger, to debug your program. 



10. Dealing with collections of files, fXfE 
revisited 

The tXtE command doesn't always execute the make program: if it is given a non-zero argument it will 
prompt for a Unix command line to be executed in place of make. All of the other parts of tXtE are 
unchanged, namely it still writes all modified buffers before executing the command and parses tlie output of 
the command execution for line numbers and file names. 

This can be used in some very powerful ways. For example, consider the grep program. Typing 
"tUtXtEgrep -n MyProc cESC" will scan all C programs in the current directory and look for all 
occurrences of the string "MyProc". After grep has finished you can use Kmacs (via the tXtN command) to 
examine and possibly change every instance of the string from a whole collection of files. This makes the task 
of changing all calls to a particular procedure much easier. Note: this only works with the version of grep in 
/usr/jag/bin which has been modified to print line numbers in a format that Emacs can understand. 

There are many more uses. The lint program, for example. Scribe users might find 
"cat MyRepoPt. otl" to be useful. 

A file name/line number pair is just a string embedded someplace in the text of the error log that has the 
form "FilcName , line LineNumber". The FileName may or may not be surrounded by quotes ("). The 
critical component is the string " , line "that comes between tlie file name and the line number. Roll 
your own file scanning programs, it can make your life much easier. 



1 1 . Abbrev mode 

Abbrev mode allows the user to type abbreviations into a document and have Emacs automatically expand 
them. If you have an abbrev called "rhp" that has been defined to expand to the string "rhinoccrous party" 
and have turned on abbrev mode then typing the first non-alphanumeric character after having typed "rhp" 
causes the string "rhp" to be replaced by "rhinocerous party". The capitalization of the typed in abbreviation 
controls the capitalization of the expansion: "Rhp" would expand as "Rhinoccrous party" and "RHP" would 
expand as "Rhinocerous Party". 
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Abbrcvintions arc defined in abbrev tables. There is a global abbrcv table which is used regardless of which 
buffer you are in, and a local abbrcv table which is selected on a buffer by buffer basis, generally depending 
on the major mode of the buffer. 

Dcfine-global-abbrev takes two arguments: the name of an abbreviation and the phrase that it is to expand 
to. The abbreviation will be defined in the global abbrev table. Define-local-abbrcv is like define-global- 
abbrcv except that it defines the abbreviation in the current local abbrev table. 

The use-abbrev-tabic command is used to select (by name) which abbrcv table is to be used locally in this 
buffer. The same abbrev table may be used in several buffers. Tlie mode packages (like clectric-c and text) 
all set up abbrcv tables whose name matches the name of the mode. 

The switch abbrev-mode must be turned on before Emacs will attempt to expand abbreviations. When 
abbrev-mode is turned on, the string "abbrev" appears in the mode section of the mode line for the buffer. 
Use-abbrev-table automatically turns on abbrev-mode if either the global or new local abbrcv tables are non- 
empty. 

All abbreviations currently defined can be written out to a file using the write-abbrev-filc command. Such 
a file can be edited (if you wish) and later read back in to define the same abbreviations again. Rcad-abbrev- 
file reads in such a file and screams if it cannot be found, quictly-read-abbrev-filc doesn't complain (it is 
primarily for use in startups so that you can load a current-directory dependant abbrcv file without worrying 
about the case where the file doesn't exist). 



1 2. Extensibility 

Unix Emacs has two extension features: macros and a built in Lisp system. Macros arc used when you 
have something quick and simple to do. Lisp is used when you want to build something fairiy complicated 
like a new language dependant mode. 

1 2.1 . Macros 

A macro is just a piece of text that Emacs remembers in a special way. When a macro is executed the 
characters that make up the macro are treated as tliough they had been typed at ilic keyboard. If you have 
some common sequence of keystrokes you can define a macro that contains them and instead of retyping 
them just call the macro. There arc two ways of defining macros: 

The easiest is called a keyboard macro. A keyboard macro is defined by typing the start-remembering 
command (tX() then typing the commands which you want to have saved (which will be executed as you type 
tlicm so that you can make sure that tlicy are right) ilien typing the slop-remcmbcring command (tX)). To 
execute the keyboard macro just type the execute-keyboard-macro command (fXc). You can only have one 
keyboard macro at a time. If you define a new keyboard macro the old keyboard macro vanishes into tJie 
mist 

Named macros are slightly more complicated. They have names, just like commands and MLisp functions 
and can be called by name (or bound to a key). They arc defined by using the definc-string-macro command 
(which must be executed by typing FJSC-Xdcnnc-string-macro since it isn't usually bound to a key) which asks 
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for tlic name of the macro and it's body. The body is typed in as a string in tlic prompt area at the bottom the 
the screen and hence all special characters in it must be quoted by prefixing them, with tO. A na.med .m.acro 
may be executed by typing ESC-Xnanic-of-macro or by binding it to a key with bind-to-key. 

The current keyboard macro can be converted into a named macro by using the define-keyboard-macro 
command which takes a name a defines a macro by that name whose body is the current keyboard macro. 

The riirrnnt kpvhnarH mnrm rpQcnc frt rtvirt 

_ ^ <OM«ftv> ww«.wv^ WW 



12.2. MLisp - iWoc/fL/sp 

Unix Emacs contains an interpreter for a language that in many respects resembles Lisp. The primary 
(some would say only) resemblance between Mock Lisp and any real Lisp is the general syntax of a program, 
which many feel is Lisp's weakest point. The differences include such things as die lack of a cons function 
and a rather peculiar method of passing parameters. 



12=2.1. The syntax of MLisp expressions 

There are four basic syntactic entities out of which MLisp expressions are built. The two simplest are 
integer constants (which are optionally signed strings of digits) and string constants (which are sequences of 
characters bounded by double quote [ ] characters ~ double quotes are included by doubling them: is 
a one character string. The third are names which are used to refer to diings: variables or procedures. These 
three arc all tied together by die use of procedure calls. A procedure call is written as a left parenthesis, "(", a 
name which refers to the procedure, a list of whitcspace separated expressions which serve as arguments, and 
a closing right parenthesis, ")". An expression is simply one of these four Uiings: an integer constant, a string 
constant, a name, or a call which may it.self be rccursivly composed of other expressions. 

String constants may contain the usual C excape sequences, "\n" is a ncwline, is a tab, "\v" is a 
carriage return. "\b" is a backsoace. "\e" is tho r<^nnp rm?^ rh 

* ' — 1-- v--"-/ «w*.s,., \tuin lo uiv, i^iiaiucLVl WilUaC u(.iai 

representation is nnn, and "t\c" is die control version of Uie character c. 

For example, die following are legal MLisp expressions: 
1 The integer constant 1. 
"hi" A two character string constant 
"\tX\tF" A two character string constant 
what? A seven character string constant 

(+ 2 2) An invocation of die "-f-" function with integer arguments 2 and 2. " + " is die usual 

addition function. This expression evaluates to die integer 4. 

(setq bert (* 4 12)) An invocation of the ftmction setq with die variable bert as its first argument and and 
expression diat evaluates die product of 4 and 12 as its second argument. The evaluation of 
diis expression assigns die integer 48 to die variable bert. 

(visit-file "mbox") An invocation of die function visii-ftle with die string "mbox" as its first argument. 

Normally die Msii-Jik function is dcd to die key tXtU. When it is invoked interactively. 
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cither by typing tXtB or ESC-Xvisit-filc, it will prompt in the minibuf for tlic name of the 
file. When called from MLisp it takes the file name from tlic parameter list All of the 
keyboard-callable function behave this way. 

Names may contain virtually any character, except whitespacc or parens and they cannot begin with a digit. 



1 2.2.2. The evaluation of MLisp expressions 

Variables must be declared {bound) before they can be used. The declare-global command can be used to 
declare a global variable; a local is declared by listing it at the beginning of a progn or a function body (ie. 
immediatly after tlic function name or the word progn and before the executable statements). For example: 

( def un 

(foo i 

(setq i 5) 

) 

■ ) 

defines a rather pointless fimction called foo which declares a single local variable / and assigns it the value 5. 
Unlike real Lisp systems, the list of declared variables is not surrounded by parenthesis. 

Expressions evaluate to values that are eitlier integers, strings or markers. Integers and strings are 
convened automaticly from one to the other type as needed: if a function requires an integer parameter you 
can pass it a string and the characters diat make it up will be parsed as an integer; similarly passing an integer 
where a string is required will cause the integer to be converted. Variables may have eidier type and their 
type is decided dynamically when the assignment is made. 

Marker values indicate a position in a buffer. They arc not a character number. As insertions and deletions 
arc performed in a buffer, markers automatically follow along, maintaining their position. Only the functions 
mark and del return markers; the user may define ones that do and may assign markers to variables. If a 
marker is used in a context tliat requires an integer value then the ordinal of tiie position within the buffer is 
used; if a marker is used in a context that requires a sU'ing value then the name of the marked buffer is used. 
For example, if there has been assigned some marker, then (pop-to-buffer there) will pop to the 
marked buffer, (goto-character there) will set dot to the marked position. 

A procedure written in MLisp is simply an expression that is bound to a name. Invoking the name causes 
the associated expression to be evaluated. Invocation may be triggered either by the evaluation of some 
expression which calls the procedure, by the user typing it's name to the ESC-X command, or by striking a 
key to which the procedure name has been bound. 

All of the commands listed in section 20 (page 32) may be called as MLisp procedures. Any parameters 
tliat tlicy normally prompt the user for arc taken as string expressions from tlie argument list in the same 
order as they are asked for interactivly. For example, liie switch- to- buffer commdind, which is normally tied to 
the tXB key, normally prompts for a buffer name and may be called from MLisp like this: 
(switch-to-buffer string-expression). 
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12.2.3. MLisp functions 

An MLiSD function, is defined hv exorntino the /ipfim fimrf^nn P.-.r r.v-.mi-.!n- 

( def un 

(silly 

(insert-string "Silly!") 

) 

defines a ftinction called silly which, when invoked, just inserts the string "Silly!" into tlie current buffer. 

MLisp has a rather strange (relative to other languages) parameter passing mechanism. The arg ftinction, 
invoked as (arg / prompt) evaluates the /*th argument of the invoking ftinction if the invoking ftmction was 
called intcractivly or, if the invoking ftinction was not called interactivly, arg uses the prompno ask you for 
the value. Consider the following function: 
(defun 

( in-parens 

(insert-string "(") 

(insert-string (arg 1 "String to insert? ")) 
(insert-string ")") 

) 

) 

If you type ESC-Xin-parcns to invoke in-parens interactivly then Emacs will ask in tJic minibuffer "String to 
insert? " and then insert the string typed into the current buffer surrounded by parentliesis. If in-parens is 
invoked from an MLisp ftmction by (in-parens "foo") then the invocation arg inside in-parens will evaluate 
the expression "foo" and the end result will be that the string "(foo)" will be inserted into the buffer. 

The ftinction interaclive may be used to determine whether or not the invoking ftinction was called 
interactivly. Nargs will return the number of arguments passed to the invoking ftmction. 

This parameter passing mechanism may be used to do some primitive language extension. For example, if 
you wanted a statement that executed a statement // times, you could use the following: 
(defun 

(dotimes n 

(setq n (arg 1)) 
(while (> n 0) 

(setq n (- n 1)) 
(arg 2) 

) 

) 

) 

Given this, the expression (dotimes 10 (insert-string "<>")) will insert the string "<>" 10 umes. [Note: The 
prompt argument may be omitted if tiie fijnction can never be called interactivly] . 



12.2.4. Debugging 

Unfortunatly, debugging MLisp ftinctions is something of a black art. The biggest problem right now is 
that if an MLisp fijnction goes into an infinite loop there is no way to stop it^ 

There is no breakpoint facility. All that you can do is get a stack trace whenever an error occurs by setting 



^Unless you arc running the "intcrruptablc" version of Emacs, in which case typing tG sill stop whatever is going on. This version of 
Emacs has the problem that by typing tC you may cause Emacs to lose track of what is on the screen. 
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the stack- irace-on- error \'anab\c. With this set, any time that an error occurs a dump of the MLisp execution 
call stack and some other information is dumped to the "Stack trace" buffer. 

12.3. A Sample MLisp Program 

The following piece of MLisp code is the Scribe mode package. Other implementations of EmaCS, on ITS 
and on Multics have modes that influence the behaviour of EmaCS on a file. This behaviour is usually some 
sort of language-specific assistance. In Unix Emacs a mode is no more that a set of fimctions, variables and 
key-bindings. This mode package is designed to be usefijl when editing Scribe source files. 
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(d^fun 



(apply-look go-forward 
(save-excurslon c 

(If (I (eolp)) (forward-character)) 

(satq go-forward -1) 

(backward-word) 

(setq c (get-tty-character)) 

(If (> c • •) 

(progn (Insert-character *8') 
(Insert-character c) 
(Insert-character '[•) 
(forward-word) 
(setq go-forward (dot)) 
(Insert-character ']•) 

) ^ 

) 

(If (- go-forward (dot)) (forward-character)) 



The applylook function makes the current word "look" different by changing the font that it 

TV nriritfi^ Ifl It OOSidOTl^. dfi! nt fhp hf*Q!nrJ!r7C fif Sll^ if.ir// C/l '.•nn i*nr, r,-!^ iii!-..-7:-c! tUs rUnn.-.s ..,;!f 

~ " " i^-'^"'*' '■- v-^i-'J-'i!. f ^ i,y ;.'JC r.i,".'!-' i'v'U vU'-i' wC'C tVYtlT/C iiiC LfiUn^^ iViii iJS 

made and reads a character from the tty. Then it inserts "@c[" (where c is the character typed) 
at the front of the word and "J" at the back. Applylook gets tied to the key ESC-I .to typing 
ESC- 1 i when the cursor is positioned on the word "begin" will change the word to "@i[beginj". 



) 

(def un 



This function is called to set a buffer into Scribe mode 

(scr1be-mode 

(remove-all -local -bindings) 

Jfihe string "LasiEditDate= ' exists in the first 2000 characters of the document then the 
following string constant is changed to the current date. The intent of this is that you should stick 
at the beginning of your file a line like: "(S'string(lx2sii:ditDate= "Sat Jul II 17:59:01 I9SI")". 
This will automatically get changed each time you edit the file to reflect that last date on which 
the file MS edited 
(If (I buffer-is-mod1f led) 
(save-excurslon 

(error-occurred 

(goto-character 2000) 
(search-reverse "LastEdltDate-""") 
(search-forward """") 
(set-mark) 

(search-forward """") 
(backward-character) 
(del ete-to-km buffer) 
(Insert-string (current-time)) 
(setq buffer-is-modif led 0) 

) 

) 

) 

(local-bind-to-key " justify-paragraph" "\ej") 
(local-bind-to-key "apply-look" "\el") 
(setq right-margin 77) 
(setq mode-string "Scribe") 
(setq case-fold-search 1) 
(use-syntax-table "text-mode") 
(modify-syntax-entry "w -•") 
(use-abbrev-table "text-mode") 
(setq left-margin 1) 
(novalue) 



(novalue) 
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12.4. More on Invoking Emacs 

When Emacs is invoked, it does several things that arc not of too much interest to the beginning user. 

1. Emacs looks for a file called " . emacs_pro" in your home directory, if it exists then it is loaded, 
with the load command. This is die mechanism used for user profiles ~ in your 8macs_pro file, 
place the commands needed to customize EmaCS to suit your taste. If a user has not set up an 
emacs_pro file then EmacS will use a site-specific default file for iniualization. At CMU this 
file is named /usr/local/lib/emacs/maclib/profile.ml 

2. Emacs will then intcrprete its command line switches. "-l<filename>" loads the given file (only 
one may be named), "-e<funcname>" executes the named function (again, only one may be 
named). -1 and -e are executed in that order, after the user profile is read, but before and file visits 
are done. This is intended to be used along witli the csh alias mechanism to allow you to invoke 
Emacs packages from the shell (that is, assuming that there is anyone out dicre who still uses the 
shell for anything other than to run under Emacs!). For example: "al ias rmail emacs - 
1 rma1 1 -ermail -com" will cause the csh "rmail" command to invoke Emacs running miail. 
Exiting rmail will exit Emacs. 

3. If neither argv nor argc have yet been called (eg. by your startup or by the command line named 
package) then the list of arguments will be considered as file names and will be visited; if there are 
no arguments then the arguments passed to the last invocation of EmaCS will be used. 

4. Finally, Emacs invokes it's keyboard command interpreter, and eventually terminates. 



13. Searching 

Emacs is capable of performing two kinds of searches^. There are two parallel sets of searching and 
replacement commands tliat differ only in the kind of search performed. 

13.1 . Simple searches 

The commands search-forward, search- reverse, quer}"- replace- string and replace- siring all do simple 
searches. That is, the search string that they use is matched directly against successive substrings of tlie buffer. 
The characters of the search string have no special meaning. These search forms are the easiest to understand 
and are what most people will want to use. They are what is conventionally bound to tS, tR, ESC-Q and 
ESC-R. 

13.2. Regular Expression searches 

The commands re-search-forward, re- search- reverse, re-query replace-string, re-replace-slring and looking-at 
all do regular expression searches. The search string is interpreted as a regular expression and matched 
against the buffer according to the following rules: 

1. Any character except a special character matches itself. Special characters are '\' '[' '.' and 
sometimes *t' '** '$'. 



' Regular 2ad Vanilla for those of you with no taste 



2. A '.' matches any character except newlinc. 

3. A *\' followed by any character except those mentioned in die following rules matches diat 
character. 

4. A '\w' Matches any word character, as defined by the syntax tables. 

5. A *\W' Matches any non-word character, as defined by the syntax tables. 

6. A \K Matches at a boundary between a word and a non-word character, as defined by the syntax 
tables. 

7. A '\B' Matches anywhere but at a boundary between a word and a non-word character, as defined 
by the syntax tables. 

8. A '\" Matches at tlie beginning of tlic buffer. 

Q A '\" \/fatrhf«: rit the- nrir\ nF tha hpfTnr 

10. A *\<' Matches anywhere before dot. 

11. A \y Matches anywhere after dot. 

12. A '\=' Matches at dot. 

13. A nonempty string s bracketed "[ s ]" (or "[t s ]" matches any character in (or not in) s. In s, '\' 
has no special meaning, and ']' may only appear as the first letter. A substring a-b, with a and b in 
ascending ASCII order, stands for the inclusive range of ASCII characters. 

i r. ■ » , iwnu.»v,vi lyjf u It 111UU.11VJ a y-uyj \ji uit auiiig uiui ujc uiai.\c:ii.'u luj^Luar expression 

beginning with die « th '\(' matched. 

15. A regular expression of one of the prcceeding forms followed by '*' matches a sequence of 0 or 
more matches of the regular expression. 

16. A regular expression, x, bracketed "\( x \)" matches what x matches. 

17. A regular expression of this or one of the precceding forms, x, followed by a regular expression of 
one of the prcceeding forms, y matches a match for x followed by a matcii for y, witli the x match 
being as long as possible while still permitting ay match. 

18. A regular expression of one of tlie prcceeding forms preceded by 't' (or followed by '$'), is 
constrained to matches that begin at tlic left (or end at the right) end of a line. 

19. A sequence of regular expressions of one of the prcceeding forms seperated by '\|'s matches any 
one of the regular expressions. 

20. A regular expression of one of the prcceeding forms picks out the longest amongst the leftmost 
matches if searching forward, rightmost if searching backward. 
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21. An empty regular expression stands for a copy of llic last regular expression encountered. 

In addition, in the replacement commands, re- query- replace- string and re-replace-slring, the characters in the 
replacement string are specially interpreted: 

• Any character except a special character is inserted unchanged. 

• A '\' followed by any character except a digit causes that character to be inserted unchanged. 

• A 'V followed by a digit n causes the string matched by the nth bracketed expression to be 
inserted. 

• An '&' causes tlie string matched by the entire search string to be inserted. 
The following examples should clear a little of the mud: 

P1ka Matches the simple string "Pika". 

Whiskey. •JackMatches the string "Whiskey", followed by the longest possible sequence of non-newline 
characters, followed by the string "Jack". Think of it as finding the first line tliat contains 
the string "Whiskey" followed eventually on the same line by the string "Jack" 

[a-z][a-z]* Matches a non-null sequence of lower case alphabetics. Using this in tlic re-replace-slring 
command along with tlie replacement string "(&)" will place parenthesis around all 
sequences of lower case alphabetics. 

Gu1 ness\ I BassMatchcs either the string 'Guiness' or the string 'Bass'. 

\Bed\b Matches 'ed' found as tlie suffix of a word. 

\bsmy\W*twit\b 

Matches the sequence of words 'silly' and 'twit' seperated by arbitrary punctuation. 

14. Keymaps 

When a user is typing to Emacs tlie keystrokes arc interpreted using a keymap. A keymap is just a table 
with one entry for each character in the ASCII character set. Each entry either names a function or anodier 
keymap. When the user strikes a key, the corresponding keymap entry is examined and the indicated action is 
performed. If the key is bound to a fijnction, then that function will be invoked. If the key is bound to 
another keymap then that keymap is used for interpreting the next keystroke. 

There is always a global keymap and a local keymap, as keys arc read from tlic keyboard the two trees arc 
traversed in parallel (you can think of keymaps as FSMs, with keystrokes triggering transitions). When eidier 
of the traversals reaches a leaf, that fijnction is invoked and interpretation is reset to the roots of the trees. 

The root keymaps are selected using the use- global- map or use-local-map commands. A new empty 
keymap is created using the defme-keymap command. 

The contents of a keymap can be changed by using tlic bind- lo- key and local- bind- lo- key comm3inds. These 
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two commands take two arguments: tlic name of the function to be bound and tlie keystroke sequence to 
which it is to be bound. This keystroke sequence is interpreted relative to the current local or global keymaps. 
For example, (bind-to-kcy "dcfinc-keymap" "\tZd") binds the define-keymap flinction to tlie keystroke 
sequence 'tZ' followed by *d'. 

A named keymap behaves just like a ftmction, it can be bound to a key or executed within an MLisp 
fijnction. When it is PYPmrpH frnm within nn MI 
relative to that map. 

The followin2 sample uses the kcvman tn narti^nllv simijlarp thp «' fHifnr rufforon^ V/«,m->r,c „^r>A 
simulate the difTerent modes in v/: command mode and insertion mode, 
(def un 

( 1nsert-befor« ; Enter insertion mode 

(usa-global-map "v1-1nsertion-mode")) 

(Insert-after ; Also enter insertion mode, but after 

; the current character 

(forward-character) 

(use-global -map "vi-1nsert1on-raode")) 

(exit-Insertion ; Exit insertion mode and return to 

; command mode 
(use-global -map "vl-comrnand-mode")) 

(replace-one 

(Insert-character (get-tty-character)) 
( delete-next-character]) 

(next-skip 

(beginning-of-line) 

(next-lino) 

(skip-white-space)) 

(prev-skip 

(beginning-of-Hne) 

(previous-line) 

(skip-white-space)) 

(skip-white-space 

(while (& (I (eolp)) (| (- (following-char) • •) (- (following-char) 'ti')n 
(forward-character))) 



) 



( vi ; Start beliaving like vi 

(use-global -map "vl-command-moda")) 



; setup vi mode tables 
(define-keymap "vi-command-mode") 
(define-keymap "vi-insertion-mode") 

(use-global-map "vi-insertion-mode") ; Setup the insertion mode map 
(bind-to-key "execute-extended-command" "\tX") 
(progn 1 

(setq 1 ' •) 

(while (< 1 0177) 

(bind-to-key "self-insert" i) 
(setq i (+ 1 1)))) 
(bind-to-key "self-insert" "\011") 
(bind-to-key "newline" "\016") 
(b1nd-to-key "self-insert" "\012") 
(bind-to-key "delete-previous-character" "\010") 



18 



bind-to-key "delete-prevlous-chsractor" "Wll") 
bind-to-key "exit-insertion" "\033") 

use-global-map "vi-conwiand-mode") ; Setup the command mode map 

b1nd-to-key "axecute-extended-consnand" "\tX") 

bind-to-key "next-Una" "\tn") 

b1nd-to-key "praw1ous-1 Ine" "V-'^p") 

bind-to-key "forward-word" *■") 

bind-to-key "backward-word" "b") 

bind-to-key "search-forward" "/") 

bind-to-key "search-reverse" "T") 

b1nd-to-key "beg1nn1ng-of-11ne" "0") 

bind-to-key "end-of-1 Ine" "$") 

bind-to-key "forward-character" " ") 

bind-to-key "backward-character" "\th") 

;b1nd-to-key "backward-character" "h") 

;b1nd-to-key "Insert-after" "a") 

;b1nd-to-key "Insert-before" "1") 

[bind-to-key "replace-one" "r") 

;b1nd-to-key "next-skip" "+") 

[bind-to-key "next-skip" "Ntm") 

[bind-to-key "prev-skip" "-") 

[use-global -map "def ault-global-keymap") 



15. Region Restrictions 

The portion of tlic buffer which Emacs considers visible when it performs editing operations may be 
restricted to some subregion of the whole buffer. 

The narrow-region command sets tlie restriction to encompass tlie region between dot and mark. Text 
outside this region will henceforth be totally invisible. It won't appear on the screen and it won't be 
manipulablc by any editing commands. It will, however, be read and written by file manipulation commands 
like read-file and write-current-file. This can be useful, for instance, when you. want to perform a replacement 
within a few paragraphs: just narrow down to a region enclosing the paragraphs and execute replace- string. 

The widen-region command sets the restriction to encompass the entire buffer. It is usually used after a 
narrow-region to restore Emacs's attention to the whole buffer. 

Save- restriction is only useful to people writing MLisp programs. It is used to save the region restriction for 
the current buffer (and only the region restriction) during the execution of some subexpression that 
presumably uses region restrictions. The value of (save-excupsion expressions . . . ) is the value of 
the last expression evaluated. 



16. Mode Lines 

A mode line is the line of descriptive text that appears just below a window on the screen. It usually 
provides a description of the state of the buffer and is usually shown in reverse video. The standard mode line 
shows the name of the buffer, an '*' if the buffer has been modified, the name of the file associated with the 
buffer, the mode of the buffer, the current position of dot within the buffer expressed as a percentage of the 
buffer size and and indication of the nesting within recursive-edit's which is shown by wrapping tlie mode line 
in an appropriate number of '[' ']' pairs. 
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It is often the case that for some silly or practical reason one wants to alter the layout of the mode line, to 
show more, less or different information. Emacs has a fairly general facility for doing this. F.nch buffer has 
associated with it a format string that describes the layout of the mode line for that buffer whenever it appears 
in a window. The format string is interpreted in a manner much like the format argument to the C printf 
subroutine. Unadorned characters appear in the mode line unchanged. The '%' character and the following 
format designator character cause some special suing to appear in the mode line in their place. The format 
designators are: 



b 


Inserts the name of the buffer. 


f 

a 


iiiov.iu lilt iiaiiii. ui uit liic daSucicticu wiul die uuilcr. 


m 


Inserts the value of the buffer-specific variable mode-siring. 


M 


Inserts the value of the variable global-mode-string. 


P 


Inserts the position of "dot" as a percentage. 


* 


Inserts an '*' if the buffer has been modified. 


I 


Inserts (recursion-depth) '['s. 


] 


Inserts (recursion-depth) 'j's. 



If a number n appears between the and the format designator then the inserted string is constrained to 
be exacdy n characters wide. Either by padding or truncating on the right. 

At CMU the default mode line is built using the following format: 
" XCBuffer: XbX» File: Xt XM (Xm) XpX]" 

The following variables arc involved in generating mode lines: 

mode- line-format This is the buffer specific variable that provides the format of a buffers mode line. 

default-mode-line-fonnat 

This is the value to which mode- line- format is initialized when a buffer is created. 

mode-string This buffer-specific string variable can be inserted into tlic mode line by using '%m' in tlie 
format. This is it's only use by Emacs. Usually, mode packages (like 'lisp-mode' or 'c- 
mode') put some string into mode-string to indicate die mode of the buffer. It is the 
appearance of this piece of descriptive information that gives the mode line its name. 

global-mode-stringT\Vis is similar to mode-string except that it is global - the same su-ing will be inserted into 
all mode lines by '%M'. It is usually used for information of global interest. For example, 
the time package puts the current time of day and load average there. 



17. Multiple Processes under Emacs 

Emacs has the ability to handle multiple interactive subprocesses. The following is a sketchy description of 
this capability. 

In general, you will not want to use any of the fiinctions described in the rest of this section. Instead, you 
should be using one of the supplied packages that invoke them, sec 19.7 page 25. For example, the "shell" 
command provides you with a window into an interactive shell and the "time" package puts the current time 
and load average (continuously updated) into the mode line. 
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Multiple interactive processes can be started under Emacs (using "start-process" or "start- Filtercd- 
process"). Processes arc tied to a buffer at inception and are thereafter known by this buffer name. Input can 
be sent to a process from the region or a string, and output from processes is normally attached to tlie end of 
the process buffer. There is also the ability to have Emacs call an arbitrary MLISP procedure to process the 
output each lime it arnves from a process (see "start-filtered-proccss"). 

Many of the procedures dealing with process management use the concept of "current-process" and 
"active-process". The current-process is usually the most recent process to have been started. Two events can 
cause the current-process to change: 

1. When the present current-process dies, the most recent of the remaining processes is popped up to 
take its place. 

2. The current-process can be explicitly changed using the "change-current-process" command. 

The active-process refers to the current-process, unless the current buffer is a live process in which case it 
refers to the current buffer. 

Below is list of the current mlisp procedures for using processes: 

active- process [unbound]: (active-process) ~ Returns the name of the active process as defined in the section 
describing the process mechanism. 

change-current-process\un\io\xn6\: (change-current-process "process-name") - Sets the current process to the 
one named. 

coniinue-process [unbound]: (continue-process "process-name") -- Continue a process stopped by stop- 
process. 

current-process [unbound]: (current- process) ~ Returns the name of the current process as defined in the 
section describing the process mechanism. 

eoi-process [unbound]: (eot-process "process-name") - Send an EO T to the process. 

inl-process [unbound]: (int-process "process-name") - Send an interrupt signal to the process. 

kill-process [unbound]: (kill-process "process-name") -- Send a kill signal to the process. 
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list- processes [unbound]: (list-processes) -- Analagous to "list-buffers". Processes which have died only 
appear once in this list before completely disappearing. 

process- output [unbound]: (process-output) - Can only be called by the on-output-procedure to procure the 
output generated by the process whose name is given by MPX-process. Returns tlic output as a string. 

process-status [unbound]: (process-status "process-name") - Returns -1 if "process-name" isn't a process, 0 if 
the process is stopped, and 1 if the process is running. 

quit-process [unbound]: (quit-process "process-name") ~ Send a quit signal to the process. 

region- to-process [unbound]: (region-to-process "process-name") ~ The region is wrapped up and sent to the 
process. 

Variable silently kill-processes; If ON EmacS will kill processes when it exits without asking any questions. 
Normally, if you have processes nmning when Emacs exits, tlie question "You have processes on die 
prowl, should I hunt them down for you" is asked, (default OFF) 

start-filtered-process[\mhomd\: (stan-filtc red-process "command" "buffer-name" "on-output-procedure") - 
Does the same thing as start-process except tliat things arc set up so that "on-output-procedure" is 
automatically called whenever output has been received from this process. This procedure can access 
the name of the process producing die output by refcring to the variable MPX-process, and can 
retrieve the output itself by calling the procedure process-output. 

The filter procedure must be careful to avoid generating sidc-cfTccts (eg. search- 

/nrwnrr/t IVlrtrrirtvor if it offoninfe fn on frn thn fnrmJn'il (nr inf/\rn-i'\ti/\n /Mtfmit frrtni nthiw 

processes may be lost. 

start-process [unbound]: (start-process "command" "buffer-name") -- The home shell is used to start a 
process executing the command. This process is tied to the buffer "buffer-name" unless it is null m 
which case the "Command execution" buffer is used. Output from the process is automatically 
attached to the end of the buffer. Each time this is done, the mark is left at tlic end of the output 
(which is die end of the buffer). 

stop-process [unbound]: (stop-process "process-name") - Tell the process to stop by sending it a stop signal. 
Use continue- process to carry on. 
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string- lo- process [unbound]: (string-to-proccss "proccss-naine" "string") -- The string is sent to tlie process. 

17.1 . Blocking 

When too many characters are sent to a process in one gulp, the send will be blocked until the process has 
removed sufficient characters from the buffer. The send will then be automatically continued. Normally this 
process is invisible to the EmacS user, but if the process has been stopped, the send will not be unblocked and 
further attempts to send to the process will result in an overwrite error message. 

17.2. Buffer Truncation 

Emacs does not allow process buffers to grow without bound. When a process buffer exceeds tlie value of 
tlic variable process-buffeHengih, 500 characters are erased fi"om the beginning of the buffer. The default 
value for process-buffer-length is 10,000. 

17.3. Problems 

The most obvious problem with allowing multiple interactive processes is that it is too easy to start up 
useless jobs which drag everyone down. Also when checkpointing is done, all buffers including the process 
buffers are checkpointed. So if you have a one line buffer keeping time, it will take more system time to 
checkpoint it than it will to keep it updated once a minute. 

In addition to anti-social problems, there are some real bugs remaining: 

• Sometimes when starting a process, it will inexplicably expire immediately. This often happens to 
the first process you fire up. 

• Subprocesses are assumed to not want to try fancy diings with the terminal. E.MACS doesn't know 
how to handle this and for now more or less ignores stty requests from processes. This means that 
csh cannot be used from within Emacs. Running chat and ftp can also cause problems. 
Someday, Emacs should try to handle stty's. 

• The worst problem is that background processes started outside Emacs will cause Emacs to hang 
when they finally finish. This might get fixed if I want to think about it. 

• If Emacs does crash or hang, you will find several orphan processes left hanging around. It is best 
to do a ps and get rid of them. 



18. The Emacs database facility 

Unix Emacs provides a set of commands for dealing with databases of a ratlier primitive form. These 
databases arc intended to be used in help facilities to find documentation for a given keyword, but they have 
many other uses: managed mailboxes or nodes in an info tree. 

A database is a set of (key, content) pairs which may be retrieved or stored based on the key. Both the key 
and thc-content may be arbitrary strings of characters. The content may be long, but tlicrc arc restrictions on 
the aggragatc length of the keys. 



23 



A database search list is a list of databases. When a key is looked up in a database search list the databases 
m Lhc search hst are examined in order for one containing the key. Pne content corresponding to the first key 
that matches is returned. When a key is to have its content changed only the first database in the search list is 
used. 

The commands available for dealing with databases are: 

exiend-database-search-Ust [unbound]: (extend-database-search-list dbname filename) adds the given data 

base file to the data hasp <;Mrrh Ikr (dh-navri'^^ ^(^tha H'.roKora iirp-^'^w >hc - v -< '■- 

left, otherwise the new database is added at the beginning of the list of databases. 

fetch-database-eniry [unbound]: (fetch-database-entry dbname key) takes the entry in the data base 
corresponding to tlie given key and inserts it into the current buffer. 

lisi-databases [unbound]: (list-databases) lists all data base search lists. 

put-daiabase-eniry [unbound]: (put-database-entry dbname key) takes the current buffer and stores it into the 
named database under the given key. 



19. Packages 

This chapter contains a description of a few of the packages Lliat have been written for Emacs in MLisp. 
To load some package, just type "ESC-X load PackageName". The title of each following section contains the 
name of the package before the 



19.1. buff -- one-line buffer list 

Loading the it/^package replaces tlie binding for tX-rB (usually list- buffers) witli one-line-bufferlisl. 

one- iine-bujjer-iisl Gives a one-line buffer list in the mini-bufi'cr. If the buffer list is longer than one line, it 
will print a line at a time and wait for a character to be typed before moving to the next 
Une. Buffers that have been changed since they were last saved arc prefixed with an 
asterisk (*), buffers widi no associated file are prefixed with a hash-mark (#), and empty 
buffers are prefixed widi an at-sign (@). 



19.2. capword - capitalize the current word 

The capword package defines one function, capilalize-word, which is conveniently bound to to KSC-C 
(although this is nol done by die package.) Capilalize-word is quite similar to case-word- upper or case-word- 
lower, except that it first sets the entire current word in lower case, then sets the first letter in upper case. For 
example, if the current word is "eMaCs", typing ESC-C will change it to "Emacs". 
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1 9.3. c-mode - simple assist for C programs 

begin-C-commenl (ESC-') Initiates the typing in of a comment. Moves the cursor over to the comment 
column, inserts " and turns on autofill. If ESC-' is typed in the first column, the the 
comment begins there, otherwise it begins where ever comment- column says it should. 

end-C-comment (ESC-') Closes off the current comment. 

indent-C- procedure 

(ESC-j) Takes the current fijnction (the one in which dot is) and fixes up its indentation by 
running it through the "indent" program. 



19.4, dired directory editor 

The dired package implements the dired command which provides some simple convenient directory 
editing facilities. When you run dired it will ask for the name of a directory, displays a listing of it in a buffer, 
and processes commands to examine files and possibly mark tlicm for deletion. When you're tlirough with 
dired it actually deletes the marked files, after asking for confirmation. The commands it recognizes are: 

d Marks the current file for deletion. A 'D' will appear at the left margin. It does not 

actually delete the file, it just marks it. The deletion will be performed when dired is 
exited. It also makes the next file be the current one. 

u Removes the deletion mark from the current file. This is the command to use if you 

change your mind about deleting a file. It also makes the next file be the current one. 

RUBOUT Removes the deletion mark from tlie line preceeding tlic current one. If you mark a file for 

deletion with 'd' the current file will be advanced to the next line. RUBOUT undoes both 
the advancing and tlie marking for deletion. 

e, V Examine a file put putting it in another window and doing a recursivc-edit on it. To 

resume dired type tC. 

r Removes the current file from the directory listing. It doesn't delete the file, it just gets rid 

of the directory listing entry. Use it to remove some of the clutter on your screen. 

q, tC Exits dired. For each file that has been marked for deletion you will be asked for 

confirmation. If you answer 'y' the file will be deleted, otherwise not. 

n, tN Moves to the next entry in the directory listing. 

p, tP Moves to the previous entry in tlie directory listing. 

tV Moves to the next page in the directory listing. 

ESC-v Moves to the previous page in the directory listing. 

ESC-< Moves to the beginning of the directory listing. 



ESC->- 



Moves to the end of tiic directory listing. 
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1 9.5. goto -- go to position in buffer 

goto-Iine Moves the cursor to beginning of the indicated line. The line number is taken from the 

prefix argument if it is provided, it is prompted for otherwise. Line numbering starts at 1. 

goto-percent Moves dot to the indicated percentage of the buffer. The percentage is taken from the 
prefix argument if it is provided, it is prompted for otherwise, (goto-pcrccnt n) goes to the 
character that is n?o from the beginning of the buffer. 

19.6. info -- documentation reader 

This is a Unix Emacs version of the ITS INFO stnicturcd documenUition reader. Loading this package 
defines one function, info, which when invoked presents you with a menu of topics. Among other things, it 
documents itself. To find out how to use info, type "h" while it is running. (To return to Emacs from info 
type"q". 

If you left info while visiting some node, giving the info command again (to the same invocation of Emacs) 
will return you to the node you were at, rather than to the directory node. You can return to the directory 
node, if you wish, by typing "d". 

Loading info, and running it the first time, both a stow operations (several seconds on an unloaded system.) 
Once initialized, however, subsequent calls will go swiftly. 

19.7. occur - find occurances of a string 

The occw/- package allows one to find tlic occurances of a string in a buffer. It contains one fimction ' 

Occurances When invoked, prompts with "Search for all occurances of: ". It then lists (in a new 
buffer) all lines contain the string you type following doL Possible options (listed at the 
bottom of the screen) allow you to page tlirough the listing buffer or abort the function. 

In addition, a global variable controls the action of the function: 

dOccu ranees- Ex Ira- Lines 

is a global variable that controls how many extra surrounding lines are printed in addition 
to the line containing tlic string found. If this variable is 0 then NO additional lines are 
printed. If this variable is greater than 0 then it will print that many lines above and below 
the line on which tlie string was found. When printing more than one line per match in 

this fashion, it will also print a sepcrator of ' ' so you can tell where the 

different matches begin and end. At the end of Uie buffer it prints '«<Hnd of Occur»>'. 

19.8. process high level process manipulation 

The process package provides high level access to the process control features of Unix Emacs. It allows 
you to interact with a shell through an Emacs window, just as though you were talking to tlie shell normally, 

shell The shell command is used to either start or reenter a shell process. When the shell 

command is executed, if a shell process doesn't exist ilien one is created (running the 
standard "sh") tied to a buffer named "shelf. In any case, the shell buffer becomes the 
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lisp 



grab-last-line 



lisp- kill-output 



pr-newline 



send-eot 



current one and doc is positioned at the end of it. In that buffer output from the shell and 
programs nm with it will appear. Anything typed into it will get sent to tlie subprocess 
when the return key is stnick. This lets you interact wiili a shell using Kmacs, and all of it's 
editing capability, as an intermediary. You can scroll backwards over a session, pick up 
pieces of text from other places and use them as input, edit while watching the execution of 
some program, and much more... 

The lisp command is exacdy the same as the shell command except that it starts up 
"cmulisp" in the "lisp" buffer. You can have both a shell and a lisp process going at the 
same time. You can even have as many shells going as you want, but this package doesn't 
support it. 

(ESC- = ) This command takes the last string typed as input to the process and brings it 
back, as though you had typed it again. So if you muff a command, just type ESC- = , edit 
the line, and hit return again. 

(tXtK) [this only applies to lisp processes] Erases the output from the last command. If 
you don't want to sec the output of tlie last command any more, just type tXtK and it will 
go away. 

(tM -- return) Takes the text of tlie current line and sends it as input to the process tied to 
the current buffer. Actually, if dot is on the last line of tiie buffer, it takes the region from 
mark to the end of the buffer and sends it as input (output from a process causes the mark 
to be set after the inserted text); if dot is not on the last line, just the text of that line is. 
shipped (presuming that your prompt is "$ "). 

(tD) If dot is at the end of the buffer, then tD behaves just as it docs outside of EmacS -- it 
sends an EOT to the subprocess (end of file to some folks). If dot isn't at the end of the 
buffer, then it does the usual character deletion. 



send- int- signal (\177 ■■ rubout) Sends an INT (Interrupt) signal to the subprocess, which should make it 
stop whatever it is doing. 

send- quit- signal (t\) Sends a QUIT signal to tlie subprocess, making it stop whatever it is doing and 
produce a core dump. 



19.9. pwd -- print and change the working directory 

pwd Prints the current working directory in the mode line, just like tlie shell command "pwd". 

cd Changes the current working directory, just like the shell command "cd". You siiould 

beware that cd only changes the current directory for HmacS, if it has already spawned a 
subprocess (a shell, for example) then a cd from witiiin EmacS has no effect on the shell. 

19.10. rmail - a mail management system 

EmaCS may be used to send and receive electronic mail. The rmail command (Usually invoked as "ESC- 
Xrmail") is used for reading mail, small is used for sending mail. 
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19.10.1. Sending Mail 

^^Kor\ cr»n r| III n-i ^il /^ifKrt** J-»w ii^Ii-;>-* / 7 m -i n — r — I-r^ r _ • f , , - — „ „ » *. • 

. - wiui-^; \j y Lioi*j^ UkX^ :iiiiUii ^UiiiiiiuiiU Kji iiUiJi VViUiui ttfiuii^ iI,iViACo CuuSlFUClS ti uliirGr 

that contains an outline of the message to be sent and allows you to edit it. All that you have to do is fill in the 
blanks. When you exit from smail (by typing tC usually -- when you're editing the message body you will be 
in a recursive-edit) the message will be sent to the destinations and blindcopied to you. Several commands 
are available to help you in composing the message: 

justify-paragraph (ESC-j) Fixes up the line breaks in the current paragraph according to the current left and 
right margins. 

exit-emacs (tC) Exits mail composition and attempts to send the mail. If all goes well the mail 

composition window will disappear and a confirmation message will appear at tlie bottom 
of the screen. If there is some sort of delivery error you will be placed back into the 
composition window and a message will appear. Bug: when delivery is attempted and 
there are errors in the delivery, the message will have been delivered to the acceptable 
addresses and not to the others. This makes retrying the message difficult since you have 
to manually eliminate the addresses to which the message has already been sent. 

mail-abort-send (tXtA) Aborts the message. If you're part-way through composing a message and decide 
that you. don't want to send it, tXtA will throw it away, after asking for confirmation. 

mail-noblind-exit (tXtC) Exits smail and send the message, just as tC will, except that a blind copy of the 
message will not be kept. 

exit-emacs (tXtF) Same as tC. 

exit-emacs (tXtS) Same as tC. 

mail-append (tXa) Positions dot at tlic end of the body and sets margins and abbrcv tables appropriatly. 
mail-cc (tXc) Positions dot to the "cc:" field, creating it if necessary. 

mail-insert (tXi) Inserts the body of tlie message that was most recently looked at with rmail into the 

body of the message being composed. If, for instance, what you want to do is forward a 
message to someone, just read the message with rmail, then compose a message to the 
person you want to forward to, and type tXi. 

mail-subject (tXs) Posiuons dot to the "subject:" field of the message. 

mail-to (tXt) Positions dot to the "to: " field of the message. 



19.10.2. Reading Mail 

The rmail command provides a facility for reading mail from within Emacs. When it is running dierc are 
usually two windows on the screen: one shows a summary of all the messages in your mailbox and the other 
displays the "current" message. The summary window may contain something like tliis: 

02621525335022 29 Oct 1981 research ! dmr [empty] 

B 02621525335030 29 Oct 1981 =>Umx-Wizards A plea for understanding 

02621525335040 31 Oct 1981 CSVAX.dmr rc etymology 

02621525335072 3 Nov 1981 EHF fyi 
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A 02621352421000 3 Nov 1981 JIM copyrights 

B 02621353040000 3 Nov 1981 =>JIM Re: copyrights • 

02621646433000 [empty] [empty] [empty] 

B 02621647417000 4 Nov 1981 =>research ! ikey Emacs 

>N 02622024522003 5 November f 1 aco cooking class 

This is broken into five columns, as indicated by the underlining. 

• The first column contains some flags: '>* indicates the current message, 'B* indicates that the 
message is a blindcopy (ie. A copy of a message that you sent to someone else), *A' indicates that 
you've answered the message, and 'N' indicates that tlie message is new. 

• The second column contains a long string of digits that is internal information for the mail system. 

• The third contains die date on which the mail was sent. 

• The forth contains the sender of the message, unless it is a blindcopy, in which case it contains the 
destination (indicated by the " = >"). 

• The fifth column contains the subject of die message. 

When in the summary window Rittail responds to the following commands: 

rmail-shell (!) Puts you into a command shell so that you can execute Unix commands. Resume mail 

reading by typing tC. 

execute-extended-command 

(:) An emergency trap-door for executing arbitrary Emacs commands. You should never 
need this. 

rmail-first-message 

(<) Look at the first message in the message file. 

rmail-last-message(>) Look at the last message in the message file. 

rmail-help (?) Print a very brief help message 

exit-emacs (tC) Leave rmail. Changes marked in the message file directory (eg. deletions) will be 

made. 

rmail-search-reverse 

(tR) Prompts for a search string and positions at the first message, scanning in reverse, 
whose directory entry contains die string. 

rmail-scarch-forward 

(tS) Prompts for a search string and positions at the first message, scanning forward, whose 
directory entry contains die string. 

rmail-append (a) Append die current message to a file. 

rmail-picvious-pagc 

(b) Moves backward in Uie window Uiat contains the current message. 
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rmail-dclctc-messagc 

(d) Flag the current messaae for deletion. If wnn'f arfnallv hp HpfftpH nnrii vn!! i«>3vr. rmcsU 

rmail-next-page (0 Moves forward in the window that contains the current message. To read a message 
that is longer than the window that contains it, just keep typing f and rmail will show you 
successive pages of iL 

rmail-goto-message 

(g) Moves to the nth message. 

smail (m) Lets you send some mail. 

rmail-next-message 

(n) Moves to the next message. 

rmail-previous-message 

(p) Moves to the previous message. 

exit-emacs (q) the same as tC • 

rmail-reply (r) Constructs a reply to the current message. 

rmail-skip (s) Moves to the nth message relative to this one. 

- rmail-undelete-message 

(u) If the current message was marked for deletion, u removes that mark. 

19.1 1 . scribe -- weak assistance for dealing with Scribe documents 

Scribe mode binds Jusiifyparagraph to ESG-j, defines appplylook and binds it to KSC-l, turns on autofill, 
sets the right margin to 77 and updates the UstEditDatc to the current date. It also binds index-eniry to ESC- 
I, and scribe-command to ESC-S. 

If the string "LastEditDate = "" exists somewhere in the first 2000 characters of the document then then the 
region extending from it to the next "" is replaced by the current date and time. You're intended to stick in 
your document something like: 

9String(LastEditDate="Sat Nov 28 11:17:29 1981") 

Emacs will automatically maintain the date. The date will only change in the file you make some changes, 
the mere act of starting scribe-mode docs not cause the date change to be permanent. 

Applyluok reads a single character and then surrounds the current word with "@c{" and "]". So, if you've 
just typed "begin", typing KSC-l-i will change it to "@i{bcgin]", which appears in tlic dcKumcnt as "begin". 
This use of the word "look" comes from the Bravo text editor. 

Index-entry takes a number of words and creates a Scribe index entry for that phrase, on a separate line. 
The current dot and mark are not modified. If the command is given with no prefix-argument, the current 
word is used as the index item. If a positive argument // is given, n words starting with liic current word arc 
used as tlie index phrase; a negative argument n causes die n words ending with the current word to be used. 
The easiest way to learn what the real nilcs are is to try it out; if you make a mistake, you can try again 
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without having to change the cursor position, then delete the wrong index entries once you've got a right one. 

Scribe-command is used to create a Begin -- End bracket pair for a specified scribe command. You are 
prompted for the name of the command (e.g., Index, Itemize, Description, etc.) For example, ESC-S Itemize 
would insert 

SBeg in( Itemize) _ 
9End( Itemize) 

and would leave the cursor on the blank line inside the begin-end brackets. If you always create scribe 
commands in this way, you'll never have unbalanced begin--ends in your scribe files. 



19.1 2. spell -- a simple spelling corrector 

The spell package implements the single fijnction spell. It provides a simple facility for doing spelling 
correction. If you invoke spell it will scan your file looking for spelling errors, tlicn it will go tlirough a 
dialogue to let you fix them up. For each misspelled word Emacs will show you the word, some context 
around it and ask you what to do. If you type 'e' or 'tG" the spelling corrector will exit. If you type ' ' it will 
ignore the word. If you type 'r' it will ask for die text to use in replacing the word and perform a query- 
replace. Bug: This uses the Unix spell command which believes Uiat its input is a source for the Unix 
standard text formatter troff/nroff; Spell misbehaves on Scribe .mss files. 



19.13. tags a function tagger and finder 

The tags package closely resembles the tags package found in Twcnex Fjviacs. The database used by the 
tag package (called a tagfile) correlates function definitions to tJie file in which the definitions appear. The 
primary function of tlie tag package is to allow the user to specify the name of a fimction, and tlien have 
Emacs locate the definition of that fijnction. The commands implemented are: 

add-tag Adds the current line (it should be tlie definition line for some ft.mction) to the current 

tagfile. 

goto-tag golo-tag takes a single string argument which is usually the name of a function and visits 

the file containing that fijnction with the first line of the function at the top of the window. 
The string may actually be a substring of the function name (actually, any substring of the 
first line of the function definition). If goto-tag is given a numeric argument then rather 
than asking for a new string it will use the old string and search for the next occurrence of 
that string in die tagfile. This is used for stepping dirough a set of tags that contain the 
same string. 

This is the most commonly used command in the tag package so it is often bound to a key: 
Twcnex Emacs binds it to ESC-., but the Unix tag package doesn't bind it to anything, it 
presumes that die user will bind it (I use tXtG). 

make-tag-table Takes a list of file names (with wildcards allowed) and builds a tagfile for all the fimctions 
in all of the files. It determines the language of the contents of tJie file from the extension. 
This command may take a while on large directories, be prepared to wait. A common use 
is to type "make-tag- table *.c". 



recomputc-all-tagsGocs through your current tag file and for each file mentioned refinds all of the tags. This 



31 



is used to rebuild an entire tag flic if you've made very extensive changes to the files 
uicntioned and die tag package is no longer able to find functions. The tagfile contains 
hinis to help the system locate die tagged function, as you make changes to die various files 
the hints become out of date. Periodically (no too often!) you should recompute die 
tagfile. 

visit-function Takes die fijnction name at or before dot, does a goto- tag on diat name, tlien puts you into 
a recursive-edit to look at the function definition. To get back to where you were, just type 
tC. This is used when you're editing somcdiing, have dot positioned at some function 
invocation, then want to look at the function. 

visit- tag- table Normally die name of die tagfile is ".tags" in die current directory. If y{'a want to use 
some other tagfile, visit-tag-table lets you do diat. 



19.14. text-mode -- assist for simple text entry 

Implements die text-mode command which ties ESC-j to justifyparagraph and sets up autofill with a left 
margin of 1 and a right margin of 77. 



19.15. time a mode line clock 

This package only implements one user-visible function, lime, which puts die current time of day and load 
average (continuously updating!) in die mode line of each window. It uses global-mode-string and die 
subproccss control facility. Major! 

19.16. transp -- transpose words or lines 

The transp package allows transposition of word and lines (similar to the function oUranspose-character) 

transpose-word Takes die two words preceding dot and exchanges dicm. (If dot is within a word, it is 
counted as preceeding dot.) 

transpose- line Takes die two lines preceding dot and exchanges dicm. (If dot is within a line, it is counted 
as preceeding dot.) 

There are also several global variables to control die transpose- line function: 

dDefault-Transpose-Direction 

(default 1) Tells transpose-line which other line to transpose with the current on. If diis is 
set to 1 (actually your favorite non-zero number will do) dicn transpose-line will use die 
line above die current one and if it is 0 transpose-line will use die line below die current 
one. 

dDefault- Transpose-follow 

(default 0) If diis is set Non-zero it will cause u-anspose-linc to leave die cursor(dot) on die 
line diat got u-ansposed, and if diis is set to Zero it will stay at die same place in die file! 

& Default- Transpose- Magic 

(default 0) This variable controls some magic inside die transpose Line function. If it is set 
to zero, transposc-line will behave as controlled by die settings of die above variables. If 
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this is set Non-Zero liicn the magic is controlled by the cursor position when transpose-line 
is invoked. If the cursor(dot) is somewhere in the middle of a line, then it behaves as if this 
variable were 0. If the cursor is at the end of a line, or at the beginning of a line, the magic 
will happen. If the cursor is at the beginning of tlie line transpose-line will override the 
above variable settings and assert that you want to transpose witli the above line and that 
you want to follow tiic line you were on. If the cursor is at the end of a line transpose-line 
will assume that you want to transpose with the next line and that you want to follow the 
line you were on. The main reason for this magic is so that you can blip lines up and down 
in your buffer real easily. 



19.17. writeregion -- write region to file 

This package only implements one function, write-rcgion-to-file, which takes the region between dot and 
mark and writes it to tlie named file. 



20. Command Description 

This chapter describes (in alphabetical order) all of the commands which are defined in the basic Unix 
Em ACS system. Other commands may be defined by loading packages. Each description names the 
command and indicates the default binding. 



(! MLisp fijnction that returns not e^. 

(! = MLisp function that returns true iff ! = e^. 



(* MLisp function that returns * e^. 



[unbound] 



[unbound] 



% [unbound] 
(% MLisp fiinction that returns % (the C mod operator). 

& [unbound] 
(& e-^ MLisp function that returns & e^. 



[unbound] 



+ [unbound] 
{+ MLisp function that returns + e^. 
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(- MLisp function that returns - e^. 



[unbound] 



/ 



(/ e^) MLisp ftjnction that returns / 



[unbound] 



< 



(< MLisp function that returns true iff < 



[unbound] 



« 



(« MLisp ainction that returns « (the C shift left operator). 



[unbound] 



<= 



(<= MLisp fijnction that returns tnie iff ^2 



[unbound] 



(= MLisp function that returns true iff = 



[unbound] 



(> e^) MLisp function that returns true iff > 



[unbound] 



>= 



(>= e^) MLisp function that returns true iff ^2 



[uni)ound] 



» 



(» e^) MLisp function that returns » (the C shift right operator). 



[unbound] 



(1- MLisp fijnction that returns t (the C XOR operator). 



[unbound] 



abort-operation 

Emacs gives up on what it is trying to do now and goes back to standard input mode. Rings the bcil. Use 
tG whenever Emacs is in a state you don't lilcc, for example, asking you for a string to be searched for when 
you decide that you don't want to search for a string. 
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active- process [unbound] 
(active-process) -- Returns the name of the active process as defined in the section describing the process 
mechanism. 

append- region- lo-bujfer [unbound! 

Appends the region between dot and mark to the named buffer. Neither the original text in the destination 
buffer nor the text in the region between dot and mark will be disturbed. 

append- to- file [unbound] 
Takes the contents of the current buffer and appends it to the named file. If the files doesn't exi^ - it will be 
created. 



apropos ESC-? 

Prompts for a keyword and then prints a list of those commands whose short description contains that 
keyword. For example, if you forget which commands deal with windows, just type "ESC-?w1 ndowKSC". 



arg [unbound] 

(arg i [prompt]) evaluates to the i'th argument of the invoking function or prompts for it if called 
interactively [the prompt is optional, if it is omitted, the function cannot be called interactivly]. For example, 
(arg 1 "Enter a number: ") 

Evaluates to the value of the first argument of the current function, if tlie current flinction was called from 
MLisp. If it was called interactively then it is prompted for. As another example, given: 
(defun (foo (+ (arg 1 "Number to increment? ") 1))) 

then (foo 10) returns 11, but typing "ESC-Xfoo" causes emacs to ask "Number to increment? Language 
purists will no doubt cringe at this rather primitive parameter mechanism, but what-the-hcll... it's amazingly 
powerful. 



or&c [unbound] 
Is an MLisp function that returns the number of arguments that were passed to EiMACS when it was 
invoked from the Unix shell. If either argc or argv are called cariy enough then Emacs's startup action of 
visiting the files named on the command line is suppressed. 



argument-prefix tU 
When followed by a string of digits tU causes that string of digits to be interpreted as a numeric argument 
which is generally a repetition count for the following command. For example, tUlOtN moves down 10 lines 
(the lO'th next). A string of n tU's followed by a command provides an argument to tliat command of 4". 
For example, tUtN moves down four lines, and tUtUtN moves down 16. Argument-prefix should neverht 
called from an MLisp fijnction. 
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^''S^ [unbound] 
(argv ;) returns the ith argument that was passed to Emacs when it W3S invoked frotn the T Jnix ^.br*!! IP 
Emacs were invoked as "emacs blatto" then (argv 1) would return the string "blatto". If cither argc or argv 
are called early enough tlien Emacs's startup action of visiting the files named on the command line is 
suppressed. 

auto-execute [unbound] 
Prompt for and remember a command name and a file name pattern. When a file is read in via visit-file or 
read-file whose name matches the given pattern the given command will be executed. The co.mmand is 
generally one which sets the mode for the buffer. Patterns must be of the form "•string" or "string*": 
"♦string" matches any filename whose suffix is "string"; "string*" matches any filename prefixed by "string". 
For example, auto-exccute c-modc *.c will put Emacs into C mode for all files with the extension ".c". 



autoload [unbound] 
(autoload command file) defines tlic associated command to be autoloadcd from the named file. When an 
attempt to execute the command is encountered, the file is loaded and llicn the execution is attempted again, 
the loading of the file must have redefined the command. Autoloading is useful when you have some 
command written in MLisp but you don't want to have tlic code loaded in unless it is actually needed. For 
example, if you have a function named box-it in a file named box-ic.ml, then the command 
(autoload "box-it" "box-it.ml") will define the box-it command, but won't load its definition from box-it.ml. 
The loading will happen when you try to execute the box-it command. 



backward- balanced- paren-line [un bound] 

Moves dot backward until either 

• The beginning of the buffer is reached. 



• An unmatched open parenthesis. '('. is encountered. That is, unmatched between there and the 
starting position of dot. 

• The beginning of a line is encountered at parenthesis level zero". That is, without an unmatched 
')' existing between there and the starting position of dot. 

The definitions of parenthesis and strings from the syntax table for the current buffer are used. 



back ward- character 

Move dot backwards one character. Ends-of-lines and tabs each count as one character, 
back to before the beginning of the buffer. 



tB 

You can't move 
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backward-paragraph ESC-[ 
Moves to the beginning of the current or previous paragraph. Blank lines, and Scribe and nroff command 
lines separate paragraphs and are not parts of paragraphs. 

backward- paren [unbound] 
Moves dot backward" until an unmatched open parenthesis, '('. or the beginning of the buffer is found. 
This can be used to aid in skipping over Lisp S-expressions. The definitions of parenthesis and strings from 
the syntax table for the current buffer are used. 

backward- sentence ESC-A 
Move dot backward to the beginning of the preceeding sentence; if dot is in the middle of a sentence, move 
to the beginning of the current sentence. Sentences are seperated by a T or '!" followed by whitcspace. 

backward-word ESC-B 
If in the middle of a word, go to tlic beginning of that word, otherwise go to die beginning of the preceding 
word. A word is a sequence of alphanumerics. 

baud-rate [unbound) 
An MLisp function that returns what Emacs thinks is the baud rate of the communication line to the 
terminal. The baud rate is (usually) 10 times the number of characters transmitted bcr second. (Baud-rate) 
can be used for such things as conditionally setting tiie display-file-perccntage variable in your EmacS profile: 
(setq display-file-pcrcentage (> (baud-rate) 600)) 

beginning-of-file ESC-< 
Move dot to just before the first character of the current buffer. 

beginmng-of-line tA 
Move dot to the beginning of the line in die current buffer that contains dot; that is, to just after the 
preceeding end-of-linc or the beginning of the buffer. 

beginning- of- window ESC-, 
Move dot to Just in front of the first character of the first line displayed in the current window. 

bind-to-key [unbound] 
Bind a named macro or procedure to a given key. All future hits on the key will cause the named macro or 
procedure to be called. The key may be a control key, and it may be prefixed by tX or ESC. For example, if 
you want ESC-= to behave the way ESC-Xprint does, then typing VSOXbind-to-key print ESC-= will do it. 
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^^^^ [unbound] 
(bobp) is an MLisp predicate which is tme iff dot is at the beeinninf of thf* HiiffWr 
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^°'P [unbound] 
(bolp) is an MLisp predicate which is true iff dot is at the beginning of a line. 

bi^ffersize [unbound] 
(buffer-size) is an MLisp ftinction that returns the number of characters in the current buffer. 

'^'""'^^ • [unbound] 

Incompletely implemented. 

^~ [unbound] 

(c= ej) MLisp function that returns, true iff e-^ is equal to taking into account the character 
translations indicated by case- fold-search and word-modc-search. If word-m.odc-scarch is in effect, then 
upper case letters are "c = " to dieir lower case equivalents. 

case-region-capitalize [unbound] 
Capitalize all the words in die region between dot and mark by making their first characters upper case and 
all the rest lower case. 

case-region- invert [unbound] 
Invert the case of all alphabetic characters in the region between dot and mark. 



case- region-lower [unbound] 
Change all alphabetic characters in the region between dot and mark to lower case. 



case-region-upper [unbound] 
Change all alphabetic characters in the region between dot and mark to upper case. 

case-word-capitalize [unbound] 
Capitalize the current word (the one above or to the left of dot) by making its first character upper case and 
all the rest lower case. 



case-word- invert [unbound] 
Invert die case of all alphabetic characters in the current word (tlic one above or to the left of dot). 
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case-word-lower [unbound] 
Change all alphabetic characters in the current word (the one above or to the left of dot) to lower case. 

case-word-upper [unbound] 
Change all alphabetic characters in the current word (the one above or to the left of dot) to upper case. 

change- current- process [unbound] 
(change-currcnt-process "process-name") -- Sets the current process to the one named. 

change- directory [unbound] 
Changes the current directory (for Emacs) to the named directory. All future file write and reads (tXtS, 
tXtV, etc.) will be interpreted relative to that directory. 

char- to- siring [unbound] 
Takes a numeric argument and returns a one character string that results from considering die number as 
an ascii character. 

Command prefix (also known as META) ESC 
The next character typed will be interpreted as a command based on the fact that it was preceded by ESC. 
Tlic name mcta for the ESC character comes from funny keyboards at Stanford and MIT tliat have a Meta- 
shift key which is used to extend die ASCII character seL Lacking a Mcta key, we make do with prefixing 
with an ESC character. You may see (and hear) commands like ESC-V referred to as Mcta-V. Sometimes the 
ESC key is confusingly written as S, so ESC-V would be written as SV. ESC is also occasionally referred to as 
Allmode, from the labeling of a key on tliose old favorites, model 33 teletypes. 

command-prefix tX 
The next character typed will be interpreted as a command based on Uic fact that it was preceded by tX. 

compile-il - tXtE 

Make is a standard Unix program which takes a description of how to compile a set of programs and 
compiles them. The output of make (and the compilers it calls) is placed in a buffer which is displayed in a 
window. If any errors were encountered, Emacs makes a note of diem for later use with tXtN. Presumably, 
a data base has been set up for make that causes the files which have been edited to be compiled. tXtE then 
updates die files that have been changed and make docs the necessary rccompilations, and EmaCS notes any 
errors and lets you pcaise them with tXtN. 

If tXtE is given a non-zero argument, dien radicr dian just executing make Emacs will prompt for a Unix 
command line to be executed. Modified buffers will still be written out, and die output will still go to die 
Error Jog bufTcr and be parsed as error messages for use with tXtN. One of die most usefiil applications of 
this feature involves the grep program. "tUtXtEgrep -n MyProc *.cESC" will scan dirough all C source files 
looking for die string "MyProc" (which could be die name of a procedure). You can dien use tXtN to step 
through all places in all the files where die string was found. Note: The version of grcp in my bin directory, 
/usr/jag/bin/grcp, must be used; it prints line numbers in a format that is understood by Emacs. (ic. 
"FileName, line LineNumber) 
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[unbound] 

Takes a set of string arguments and returns their concatenation. 

conlinue-process [unbound] 
(continuc-process "process-name") -- Continue a process stopped by stop-process. 

coprregion-lo-bujfer [unbound] 
Copies the region between dot and mark to the named buffer. The buffer is emptied before the text is 
copied into if the rroinn hetw^en Hot ^nri rpqrV J" ipfv 

currenl-buffername [unbound] 
MLisp function that returns the current buffer name as a string. 

current-column [unbound] 
(current-column) is an MLisp function that returns the printing column number of the character 
immediately following doL 

current-file-name [unbound] 
IVILisp ftinction that returns the file name associated with the current buffer as a string. If there is no 
associated file name, the null string is returned. 

current-indent [unbound] 
(current-indent) is an MLisp ftmction the returns the amount of whitespace at the beginning of llie line 
which dot is in (the printing column number of tiic first non-whitespacc character). 

current-process [unbound] 
(current-process) - Returns the name of the current process as defined in tlie section describing tlie process 
mechanism. 



current-time [unbound] 
MLisp function tliat returns tlie current time of day as a string in the format described in CTIMH(3), with 
the exception that the trailing newline will have been stripped off. (substr (current-time) -4 4) is the current 
year. 



dedare-global [unbound] 
Takes a list of variables and for each tliat is not already bound a global binding is created. Global bindings 
outlive all function calls. 
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define- buffer macro [unbound] 
Take the contents of the current bufTcr and define it as a macro whose name is associated with the buffer. 
This is how one redefines a macro that has been edited using edit-macro. 

define- global- abbrev [unbound] 
Define (or redefine) an abbrev with the given name for the given phrase in the global abbreviation table. 

define- keyboard- macro [unbound] 
Give a name to the current keyboard macro. A keyboard macro is defined by using the tX( and tX) 
command; dcfinc-kcyboard-macro takes the current keyboard macro, squirrels it away in a safe pL -c, gives it 
a name, and erases the keyboard macro, definc-string-macro is another way to define a macro. 

define-keymap [unbound] 
(dcfine-keymap "mapnamc") defines a new, empty, keymap with the given name. See tlie section on 
keymaps, 14 page 16, for more information. 

define- local-abbrev [unbound] 
Define (or redefine) an abbrev with the given name for the given phrase in the local abbreviation table. A 
local abbrev table must have already been set up with use- abbrev- table. 

define-slring-macro [unbound] 
Define a macro given a name and a body as a string entered in die minibuffer. Note: to get a control 
character into die body of the macro it must be quoted with tQ. dcfine-keyboard-macro is another way to 
define a macro. 

(fefun [unbound] 
(defun (name expressions... )... ) is an MLisp fijnction that defines a new MLisp function with the given 
name and a body composed of the given expressions. The value of the ftmction is die value of die last 
expression. For example: 

(defun 

(indent-line ; this function just sticks a tab at 

(save-excursion ; the beginning of the current line 

(beginning-of-l ine) ; without moving dot. 
(insert-string " ") 

) 

) 

) 



delete-bujfer 

Deletes the named buffer. 



[unbound] 
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delele-macro [unbound] 
Delete die named macro. 

delete- next-characler tj) 

Delete the character immediatly following dot; that is, the character on which the terminals cursor sits. 
Lines may be merged by deleting newlines. 

delete- next-word ESC-D 
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punctuation up to the beginning of the word is deleted as well as the word. 

delete-other windows ^Xl 
Go back to one-window mode. Generally useful when Emacs has spontaneously generated a window (as 
for ESC-? or tXtB) and you want to get rid of it. 

delete-previous-character tj.j 
Delete the character immediatly preceding dot; that is, the character to the left of the terminals cursor. If 
you've just typed a character, tH (backspace) will delete it. Lines may be merged by deleting newlines. 

delete- previous-character RUBOUT 
Delete the character immediatly preceding dot; that is. the character to the left of the terminals cursor. If 
you've just typed a character, RUBOUT will delete it. Lines may be merged by deleting newlines. 

delete- previous-word ESC-H 
If not in die middle of a word, delete characters backwards (to die left) until a word is found. Then delete 
the word to die left of dot. A word is a sequence of alphanumer!,cs. 

delete- region-to-buffer ESC-tW 
Wipe (kill, delete) all characters between dot and die mark. The deleted text is moved to a buffer whose 
name is prompted for, which is emptied first. 

delete- to-killbuffer tW 
Wipe (kill, delete) all characters between dot and die mark. The deleted text is moved to die kill buffer, 
which is emptied first. 



delete- white- space 

Deletes all whitespace characters (spaces and tabs) on either side of dot. 



[unbound] 
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delete- window tXD 
Removes the current window from the screen and gives it's space to it's neighbour below (or above) and 
makes the current window and buffer those of the neighbour. 

describe- bindings [unbound] 
Places in the Help window a list of all tlie keys and the name of the procedure that they arc bound to. This 
listing is suitable for printing and making you own quick-reference card for your own customized version of 
Emacs. 

describe- command [unbound] 
Describe the named extended command. An "extended command" is tiic first word that you type to the 
ESC-X command. "ESC-Xdescrlbe-command descrlbe-command" will print the documentation for 
the describe-command extended command. 

describe-key [unbound] 
Describe die given key. ESC-Xdescribe-key ESC-X will print the documentation for the ESC-X key. 

describe-variable [unbound] 
Describe die named variable. A "variable" is something that you can set with die ESC-Xset command or 
print with the ESC-Xprint command. They let die user fine-tune Emacs to their own taste. 
ESC-Xdescribe-var1able right-margin will print documentation about die right-margin setting. 

describe- word- in- buffer tXtD 
Takes the word nearest the cursor and looks it up in a data base and prints the information found. This 
data base contains short one-line descriptions of all of the Unix stondard procedures and Franz Lisp stanliard 
functions. The idea is diat if you've just typed in the name of some procedure and can't quite remember 
which arguments go where, just type tXtD and EmacS will try to tell you. 

digit [unbound] 
Heavy wizardry: you don't want to know, "digit" should eventually disappear. 

dot [unbound] 
(dot) is an MLisp function diat returns the number of characters to die left of dot plus 1 (ie. if dot is at die 
beginning of die buffer, (dot) returns 1). The value of die function is an object of type "marker" - if it is 
assigned to a variable dien as changes arc made to die buffer die variable's value continues to indicate the 
same position in die buffer. 
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dump-synlax-table ' [unbound] 

Dumps a readable listins 



[unbound] 

rake the body of the named macro and place it in a buffer called Macro edit. The name of tlic macro is 
associated widi the' buffer and appears in the information bar at the hnrtnm nf thp winHnu; Tho huffier mow 
be edited just like any other buffer (this is, in fact, the intent). After the macro body has been edited it may 
be redefined using defuie-bujfermacro. 

end-of'fde gg^,.^ 
Move dot to just after the last character of the buffer. 

end- of- line ^£ 

Move dot to the end of the line in the current buffer that contains dot; that is, to just after the following 
end-of-line or the end of the buffer. 

end- of- windo w ESC- 
Move dot to just after the last character visible in the window. 

enlarge-window 

Makes the current window one line taller, and the window below (or the one above if there is no window 
below) one line shorter. Can't be used if tliere is only one window on the screen. 

^''^^ [unbound] 
(eobp) is an MLisp predicate that is true iff dot is at the end of the buffer. 

^^^^ [unbound] 
(eolp) is an MLisp predicate that is true iff dot is at the end of a line. 

<^'''-P'-ocess [unbound] 
(eot-process "process-name") -- Send an EOT to the process. 

erase-buffer [unbound] 
Deletes all text from the current buffer. Doesn't ask to make sure if you really want to do it. 



erase- region 

Erases the region between dot and mark, 
to the kill buffer. 



[unbound] 

It is like delete-to-killbuffer except that it doesn't move the text 
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error-message [unbound] 
(error-mcssagc "string-expression") Sends Uic siring-expression to the screen as an error message where it 
will appear at the bottom of the screen. Emacs will return to keyboard level. 

error-occured [unbound] 
(error-occured expressions...) executes the given expressions and ignores their values. If all executed 
succcssfiilly, error-occured returns false. Otherwise it returns tnie and all expressions after the one which 
encountered the error will not be executed. 

exchange-dot-and-mark . tXtX 

Sets dot to the currently marked position and marks the old position of dot. Useful for bouncing back and 
forth between two points in a file; particularly useful when the two points delimit a region of text that is going 
to be operated on by some command like tW (erase region). 

execuie-extended-command ESC-X 
Emacs will prompt in the minibuffer (the line at the bottom of the screen) for a command from the 
extended seL llicse deal with rarely used features. Commands are parsed using a Twencx style command 
interpreter: you can type ESC or space to invoke command completion, or '?' for help with what you're 
allowed to type at that point. This doesn't work if it's asking for a key or macro name. 

execute-keyboard-macro tXE 
Takes the keystrokes remembered with tX{ and tX) and treats them as though tliey had been typed again. 
This is a cheap and easy macro facility. For more power, see the de fine-string- macro, define-keyboard-macro 
and bind-to-key commands. 

execule-mlisp-bujjer [unbound] 
Parse the current buffer as as a single ML.isp expression and execute it. This is what is generally used for 
testing out new fi.mctions: stick your functions in a buffer wrapped in a defim and u.sc cxccutc-mlisp-buffcr to 
define them. 

execute-mlisp-line ESC- ESC 

Prompt for a string, parse it as an MLisp expression and execute it. 

execute-monilor-command tX! 

Prompt for a Unix command then execute it, placing its output into a buffer called Cortimand execulion 
and making tliat buffer visible in a window. The command will not be able to read from its standard input (it 
will be connected to /dcv/nuil). For now, there is no way to execute an interactive subprocess. 
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exit-eimcs 

Exit EmaCS. Will ask if you're sure if Lhere are anv bufTers Lh.ir h.nvp hppn mnH-npH h: 



exil-emacs tXtC 
Exit Emacs. Will ask if you're sure if there are any buffers that have been modified but not written out. 

exil-emacs YSC-tC 
Exit Emacs. Will ask if you're sure if there are any buffers that have been modified but not written out. 

expand-mlisp-variable [unbound] 
Prompts for the name of a declared variable then inserts the name as text into the current buffer. This is 
very handly for typing in MLisp functions. It's also fairly useail to bind it to a key for easy access. 

expand-mlisp-word [unbound] 
Prompt for the name of a command then insert the name as text into Lhc current buffer. This is very 
handly for typing in MLisp functions. It's also fairly useful to bind it to a key for easy access. 

exiend-database-search-list [unbound] 
(extcnd-database-search-list dbname filename) adds the given data base file to the data base search list 
(dbname). If tlie database is already in the search list then it is left, otherwise the new database is added at the 
beginning of the list of databases. 

fetch-database-entry [unbound] 
(fetch-databasc-cntry dbname key) takes the entry in the data base corresponding to the given key and 
inserts it into the current buffer. 

f'l^exisis [unbound] 
(f He-exists fn) returns I if the file named by/// exists and is writable, 0 if it does not exist, and -1 if 
it exists and is readable but not writable. 

filter-region [unbound] 
Take the region between dot and mark and pass it as the standard input to the given command line. Its 
standard output replaces the region between dot and mark. Use tliis to run a region through a Unix style- 
filter. 

following-char [unbound] 
(following-char) is an MLisp function tliat returns the character immcdiatly following dot. The null 
character (0) is returned if dot is at tlie end of the buffer. Remember that dot is not 'at' some character, it is 
between two characters. 
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forward-balanced-paren-Une [unbound] 
Moves dot forward until citlacr 

• The end of the bufTer is reached. 

• An unmatched close parenthesis, ')', is encountered. That is, unmatched between there and the 
staning position oFdoL 

• The beginning of a line is encountered at "parenthesis level zero". That is, witliout an unmatched 
'(' existing between there and the starting position of dot. 

The definitions of parenthesis and strings from the syntax table for the current buffer are used. 

forward- character tF 
Move dot forwards one character. Ends-of-lines and tabs each count as one character. You can't move 
forward to after the end of the buffer. 

forward- paragraph ESC-] 
Moves to tlic end of the current or following paragraph. Blank lines, and Scribe and nroff command lines 
separate paragraphs and are not parts of paragraphs. 

forward-paren [unbound] 
Moves dot forward until an unmatched close parendiesis, ')', or the end of the buffer is found. This can be 
used to aid in skipping over Lisp S-expressions. The definitions of parenthesis and smngs from the syntax 
table for the current buffer are used. 

forward- sentence ESC-E 
Move dot forward to the beginning of the next sentence. Sentences are seperated by a "?' or '!' followed 
by whitespacc. 

forward- word ESC--F 
Move dot forward to the end of a word. If not currently in the middle of a word, skip all intervening 
punctuation. Then skip over the word, leaving dot positioned after the last character of the word. A word is a 
sequence of alphanumerics. 



get-tty-buffer [unbound] 
Given a prompt string it reads the name of a buffer from the tty using the minibuf and providing command 
completion. 
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gcHlycharacter [unbound] 
Reads a single character from the terminal and 

" liuis. iJiJ ! — 1 m Lw^*— ± , lli^ wUa jvyi i^j i ii V Ll JV 

message area, it is left in the text window. This is useftil when writing things like query-replace and 
incremental search. 

get-lly-command [unbound] 
(get-tty-command prompt) prompts for the name of a declared flinction (using command completion & 
providing help) and returns the name of the fiinction as a string. For example, the expand- mlisp-word 
function is simply (inscrt-strine fect-ttv-command "• MnanH-miicn-u/nrH "^^ 

get-lty-slring [mhouM] 
Reads a string from the terminal using its single string parameter for a prompt. Generally used inside 
MLisp programs to ask questions. 

get-tty-mriable [unbound] 
(get-tty-variable prompt) prompts for the name of a declared variable (using command completion & 
providing help) and returns the name of die variable as a string. For example, the expand- mlisp-variable 
function is simply (insert-string (get-tty-variable ": expand-mlisp- variable ")). 

^''"'y [unbound] 
(getenv "vantame") returns the named shell environment variable, for example, (getenv "HOME") will 
return a string which names your home directory. 

goto-character [unbound] 
Goes to the given character-position, (goto-charactcr 5) goes to character position 5. 

'■^ , [unbound] 

(if test thenclause elseclausc) is an MLisp function Uiat executes and returns the value of thenclause iff test 
is true; otherwise it executes elseclause if it is prescnL For example: 
(if (eoip) 

(to-col 33) 

) 

will tab over to column 33 if dot is currently at the end of a line. 

illegal-operation [unbound] 
Illegal-operation is bound to those keys that do not have a defined interpretation. F.xccuting illegal- 
operation is an error. 
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indenl-C- procedure ESC- J 

Take die current C procedure and reformat it using the indent program, a fairly sophisticated pretty printer. 
Indetil-C- procedure is God's gift to those who don't like to fiddle about getting their formatting right. Indent- 
C-procedure is usually bound to ESC-J. When switching from mode to mode, ESC-J will be bound to 
procedures appropriate to that mode. For example, in text mode ESC-J is bound to justify paragraph. 

insert-character [unbound] 
Inserts its numeric argument into the buffer as a single character, (insert-character '0') inserts the character 
'0' into the buffer. 

insert- file tXtl 
Prompt for the name of a file and insert its contents at dot in the current buffer. 

insert-string [unbound] 
(insert-string stringexpression) is an Ml.isp fiinction that inserts the string diat results from evaluating tlie 
given stringexpression and inserts it into die current buffer just before dot. 

int-process [unbound] 
(int-process "process-name") ~ Send an interrupt signal to die process. 

interactive [unbound] 
An MLisp function which is true iff the invoking MLisp function was invoked interactively (ie. bound to a 
key or by ESC-X). 

is-bound [unbound] 
an MLisp predicate that is true iff all of its variable name arguments are bound. 

justify-paragraph [unbound] 
Take the current paragraph (bounded by blank lines or Scribe control lines) and pipe it through the "fmt" 
command which does paragraph justification, justify-paragraph is usually bound to VS>C-i when in text 
mode. 

kill-process [unbound] 
(kill-process "process-name") Send a kill signal to the process. 

kill-to-end-of-line tK 
Deletes characters forward from dot to the immediatly following end-of-linc (or end of bufTcr if there isn't 
an end of line). If dot is positioned at the end of a line then tlic end-of-line character is deleted. Text deleted 
by the tK command is placed into the Kill buffer (which really is a buffer that you can look at). A tK 
command normally erases the contents of the kill buffer first; subsequent tK's in an unbroken sequence 
append to the kill buffer. 
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lasi- key-struck [unbound] 
The last comrnand character struck. If vou have a function bound to m.anv kovs the funcrion mnv u^.p lasf- 
key-struck to tell which key was used to invoke iL (insert-character (last-kcy-stnick)) does the obvious thing. 

length [unbound] 
Returns the length of its string parameter, (length "time") => 4. 

line-lo-top-of-window ESC-! 

What more can I say? This one is handy if you've just searched for the declaration of a procedure, and 
want to see the whole body (or as much of it as possible). 

list- buffers tXtB 
Produces a listing of all existing buffers giving their names, the name of the associated file (if there is one), 
the number of characters in the buffer and an indication of whether or not tlic buffer has been modified since 
it was read or written from the associated file. 

list-databases [unbound] 
(list-databases) lists all data base search lists. 

list-processes [unbound] 
(list-processes) -- Anaiagous to "list-buffers". Processes which have died only appear once in this lisf 
before completely disappearing. 

load [unbound] 
Read the named file as a series of MLisp expressions and execute them. Typically a loaded file consists 
primarily of de funs and buffer-specific variable assignments and key bindings. Load is usually used to load 
macro libraries and is used to load ".cmacs.pro" from your home directory when EmacS starts up. 

For example, loading this file: 

(setq right-margin 75) 
(defun (my-l inefeed 

(end-of-1 ine) 

(new! ine- and -indent) 

) 

) 

(bind-to-key "my-l inefeed" 10) 

sets the right-margin to 75 and defines a fiinction called mylinefeed and binds it to tJie linefeed key (which is 
the ascii character 10 (decimal)) 

The file name given to load is interpreted relative to the EPATH environment variable, which is interpreted 
in the same manner as the shell's PATH variable. That is, it provides a list of colon-separated names that are 
taken to be tlie names of directories that are searched for the named files. The default value of EPATH 
searches your current directory and then a central system directory. 



Temporary hack: in previous versions of Emacs loadQd files were treated as a sequence of keystrokes. This 
behaviour has been decreed bogus and unreasonable, hence it has been changed. However, to avoid loud 
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cries of anguish the load command still exhibits the old behaviour if the first character of tlic loaded file is an 
ESC. 



local-bind- to-key [unbound] 
Prompt for the name of a command and a key and bind that command to the given key but unlike bind-to- 
key the binding only has effect in the current buffer. This is generally used for mode specific bindings that 
will generally differ fi-om buffer to buffer. 



looking-at [unbound] 
(looking-at "SearchString") is true iff the given regular expression search stiing matche> the text 
immediatly following dot. This is for use in packages that want to do a limited sort of parsing. For example, 
if dot is at the beginning of a line then (looking-at "[ \t]*clsc]) will be true if the line starts with an "else". See 
section 13, page 14 for more information on regular expressions. 



""^'■'^ [unbound] 
An MLisp flinction that returns the position of the marker in the current buffer. An error is signaled if the 
marker isn't set The value of the function is an object of type "marker" -- if it is assigned to a variable then as 
changes are made to the buffer die variable's value continues to indicate the same position in die buffer. 



"^^^^age [unbound] 
(message stringexpression) is an MLisp Rjnction that places the string that results from the evaluation of 
the given stringexpression into die message region on tlie display (tlie line at Uic bottom). 



modify-syntax-entry [unbound] 
Modify-syntax-entry is used to modify a set of entries in the syntax tabic associated with tlie current buffer. 
Syntax tables are associated with buffers by using the use- syntax- table commmd. Syntax tables are used by 
commands forward- paren to do a limited form of parsing for language dependent routines. They define 
such things as which characters are parts of words, which quote strings and which delimit comments 
(currently, nothing uses the comment specification). To see the contents of a syntax table, use the dump- 
syntax- table command. 

The parameter to modify-syntax-entry is a string whose first five characters specify the interpretation of die 
sixth and following characters. 

The first character specifies die type. It may be one of the following: 
'w' A word character, as used by such commands as forward- word and case- word- capitalize. 

space A character with no special interpretation. 

'(' A left parendiesis. Typical candidates for Uiis type are die characters '(', '[' and '{'. 

Characters of diis type also have a matching right parendiesis specified (')'. ']' and '}' for 
example) which appears as die second character of die parameter to modif}'- syntax- entry. 

')* ■ A right parendiesis. Typical candidates for diis type are die characters ')', ']' and '}'. 

Characters of diis type also have a matching left parendiesis specified ('(', '[' and '{' for 
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example) which appears as the second character of tlic parameter to modifysynlax-entry. 

A quote character. The C string delimiters " and ' are usually given this class, as is tlie Lisp 
I. 

'\' A prefix character, like \ in C or / in MacLisp. 

uie second character of the parameter is the matching parenthesis if the character is of the left or right 
parenthesis type. If you specify that '(' is a right parendiesis matched by ')'. tlicn you should also specify that 
')' is a left parenthesis matched by '('. 

The third character, if equal to '{', says that the character described by this syntax entry can begin a 
comment; the forth character, if equal to '}' says that the character described by this syntax entry can end a 
comment. If either the beginning or ending comment sequence is two characters long, dien the fifth character 
provides the second character of the comment sequence. 

The sixth and following characters specify which characters arc described by this entry; a range of 
characters can be specified by putting a '-' between them, a can be described if it appears as the sixth 
character. 



A few examples, to help clear up my muddy exposidon: 

(modify-syntax-eniry "w -'■) : makes '-' behave as a normal word 

: character (ESC-F will consider 

; one as part of a word) 
(modily-syntax-cntry "0 [") ; makes '[' behave as a left parenthesis 

; which is matched by ']' 
(modify-syntax-entry ")[ J") ; makes ']' behave as a right parenthesis 

: which is matched by '[' 



move- to- comment- column u^n^^n„^A^ 
If the cursor is not at the beginning of a line, ESC-C moves die cursor to the column specified by the 
comment-column variable by inserting tabs and spaces as needed. In any case, it the sets die right margin to 
the column finally reached. This is usually used in macros for language-specific comments. 



"^'■^^ [unbound] 
An MLisp ftmction which returns the number of arguments passed to the invoking MLisp function. For 
example, within the execution of foo invoked by (foo x y) die value o^nargs will be 2. 



narroy^region [unbound] 
The narrow-region command sets die restriction to encompass die region between dot and mark. Text 
outside diis region will henceforth be totally invisible. It won't appear on the screen and it won't be 
manipulablc by any edidng commands. This can be useful, for instance, when you want to perform a 
replacement widiin a few paragraphs: just narrow down to a region enclosing die paragraphs and execute 
replace- siring. 
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newline [unbound] 
Just inserts a newline character into the buffer -- this is what the RETURN (tM) key is generally bound to. 

newline-and-backup tO 
Insert an cnd-of-linc immediatly after dot, effcctivly opening up space. If dot is positioned at the beginning 
of a line, then tO will create a blank line preceding die current line and position dot on that new line. 

newline- and- indent LINEFEED 
Insert a newline, just as typing RETURN does, but then insert enough tabs and spaces so that the newly 
created line has the same indentation as the old one had. This is quite useful when you're typing in .-: block of 
program text, all at die same indentadon level. 

next-error tXtN 
Take the next error message (as returned from Uic tXtE (compile) command), do a visit (tXtV) on the file 
in which the error occurred and set dot to die line on which die error occurred. The error message will be 
displayed at the top of the window associated with the Error log buffer. 

next-line tN 
Move dot to the next line. tN and tP attempt to keep dot at the same horizontal position as you move 
from line to line. 

next-page tV 
Reposition the current window on the current buffer so that the next page of the buffer is visible in the 
window (where a page is a group of lines slightly smaller than a window). In other words, it flips you forward 
a page in the buffer. Its inverse is ESC-V. If possible, dot is kept where it is, otherwise it is moved to die 
middle of the new page. 

next-window tXN 
Switches to die window (and associated buffer) diat is below the current window. 

novalue [unbound] 
Does nothing, (novalue) is a complete no-op, it performs no action and returns no value. Generally die 
value of a fijnction is the value of the last expression evaluated in it's body, but this value may not be desired, 
so (novalue) is provided so that you can dirow it away. 

page- next- window ESC-tV 
Repositions die window below the current one (or the top one if the current window is the lowest one on 
the screen) on the displayed buffer so diat die next page of die buffer is visible in die window (where a page is 
a group of lines slightly smaller dian a window). In odier words, it flips you forward a page in die buffer of 
the other window. 



If ESC-tV is given an argument it will flip the buffer backwards a page, rather dian forwards. So ESC-tV 
is roughly equivalent to tV and tUK5C-tV is roughly equivalent to ESC-V except diat diey deal widi the 
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other window. Yes, yes, yes. I realize that this is a bogus command structure, but I didn't invent it. Besides, 
you can learn to love iL 



parse-error-messages-in-region [unbound] 
Parses the region between dot and mark for error messages (as in the compile-it (tXtE) command) and sets 
up for subsequent invocations of next-error (tXrN). See the description of the compile-it command, and 
section 9 (page 6). 



w..f.t^ (unbounaj 
Pause, giving control back to the superior shell using the job control facility of Berkeley Unix. The screen 
is cleaned up before the shell regains control, and when the shell gives control back to Emacs the screen will 
be fixed up again. Users of the sea-shell (csh) will probably rather use this command than "rcturn-to- 
monitor", which is similar, except that it recursivly invokes a new shell. 



pop-to-bujfer [unbound] 
Switches to a buffer whose name is provided and tics that buffer to a popped-up window. Pop-to-buffer is 
exactly the same as switch- to-buffcr except that switch-to-buffer tics the buffer to the current window, pop-to- 
buffcr finds a new window to de it to. 



preceding-char [unbound] 
(preceding-char) is an MLisp Rinction that returns the character immediatly preceding dot.- The null 
character (0) is returned if dot is at the beginning of the buffer. Remember that dot is not 'at' some character, 
it is between two characters. 



prefix-argument-loop [unbound] 

— »ov«vvit.».i.«.j<- / VAV.I.U1.V.} xjiaiviin-iiux pn-uA-jigLiiiiciu uiiicb. cvLTy lunciion 

invocation is always prefixed by some argument, usually by the user typing tU/(. If no prefix argument has 
been provided, 1 is assumed. See also the command providc-prcfix-argument and the variable prefix- 
argument. 

previous-command [unbound] 
(previous-command) usually returns the character value of the keystroke that invoked the previous 
command. In is something like last- kei" struck, which returns the keystroke that invoked tlic current 
command. However, a Hinction may set the variable ihis-command io some value, which will be the value of 
previous- command after the next command invocation. This rather bizarre command/variable pair is 
intended to be used in the implementation of MLisp fxinctions which behave differently when chained 
together (ic. executed one aflcr tlie other). A good example is tK, kill-to-end-of-line which appends tlie text 
from chained kills to die killbuffer. 

To use this technique for a set of commands which are to exhibit a chaining behaviour, first pick a magic 
number. -84, say. Then each command in this set which is chainable should 
(setq th1s-command -84). Then to tell if a command is being chained, it suffices to check to see if 
(previous-command) returns -84. 
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bid I hear you scream "hack"?? 
previous- line 

Move dot to the previous line. tN and tP attempt to keep dot at the same horizontal position as you move 
from line to line. 

previous-page ESC-V 
Repositions the current window on the current buffer so that tlie previous page of the buffer is visible in 
the window (where a page is a group of lines slightly smaller than a window). In other words, it flips you 
backward a page in the buffer. Its inverse is tV. If possible, dot is kept where it is, otherwise it is moved to 
the middle of the new page. 

previous- window '•"XP 
Switches to tlie window (and associated buffer) that is above die current window. 

prim [unbound] 
Print the value of the named variable. This is the command you use when you want to inquire about tlie 
setting of some switch or parameter. 

process-oulpul [unbound] 
(process-output) -- Can only be called by the on-output- procedure to procure the output generated by die 
process whose name is given by MPX-process. Returns the output as a string. 

process-status [unbound] 
(process-status "process-name") ~ Returns -1 if "process-name" isn't a process, 0 if the process is stopped, 
and 1 if the process is running. 

progn [unbound] 
(progn expressions...) is an MLisp function diat evaluates the expressions and returns the value of the last 
expression evaluated. Progn is roughly equivalent to a compound statement (bcgin-end block) in more 
conventional languages and is used where you want to execute several expressions when there is space for 
only one (eg. the then or else parts of an //expression). 

provide-prefix-argument [unbound] 
(provldc-prcfix-argumcnt <valuc> <statcmcnt>) provides the prefix argument <valuc> to the <statcmcnt>. 
For example, the most efficient way to skip forward 5 words is: 
( prov idG-pref ix-argument 5 (forward-word)) 

See also the command prefix-argument-loop and the variable prefix-argumenL 
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push- back-character [unbound] 
Takes the character nrovided as its areument and causes it to be used as the next charnctor rond from the 
keyboard. It is generally only useful in MLisp functions which read characters from tlie keyboard, and upon 
finding one that they don't understand, terminate and behave as though the key had been struck to the 
Emacs keyboard command interpreter. For example, ITS style incremental search. 



put-daiabase-entry [unbound] 
(put-database-entry dbname key) takes the current buffer and stores it into the named database under the 
given key. 

query- replace- string ESC-Q 
Replace all occurrences of one string with another, starting at dot and ending at the end of the buffer. 
Emacs prompts for an old and a new string in the minibuffer (the line at the bottom of the screen). See the 
section on searching, section 13 page 14 for more information on search strings. For each occurrence of the 
old string, E.MACS requests diat the user type in a character to tell it what to do (dot will be positioned jur.t 
after the found string). The possible replies arc: 

<space> Change this occurrence and continue to the next. 

n Don't change this occurrence, but continue to tlic next 

r Enter a recursive-cdit. This allows you to make some local changes, tlien continue 

the query-rcplace-string by typing tC. 
! Change this occurrence and all the rest of the occurrences without bothering to 

ask. 

Change this one and stop: don't do any more replaces. 
Don't change this occurrence and stop: don't do any more replaces, 
(or anything else) Print a short list of the query/replace options. 
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quietly- read-abbrev-file (unbound] 
Read in and define abbrevs appearing in a named file. This file should have been written using write- 
abbrev-file. Unlike read- abbrev- file, an error message is not printed if tlie file cannot be found. 



quit-process [unbound] 
(quit-process "process-name") - Send a quit signal to the process. 

quote-character tQ 
Insert into the buffer the next character typed witliout interpreting it as a command. This is how you insert 
fiinny characters. For example, to insert a tL (form feed or page break character) type tQtL. This is the only 
situation where tG isn't interpreted as an abort character. 
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re-query-replace-string [unbound] 
re- query- replace-siring is identical to query- replace- siring except that the search string is a regular 
expression rather than an uninterpreted sequence of characters. See the section on searching, section 13 page 
14 for more information. 

re- replace- string [unbound] 
re-replace-string is identical to replace- string except that the search string is a regular expression rather than 
an uninterpreted sequence of characters. See the section on searching, section 13 page 14 for more 
information. 

re- search- forward [unbound] 
re- search- forward is identical to search-forward except that the search string is a regular expression rather 
than an uninterpreted sequence of characters. Sec the section on searching, section 13 page 14 for more 
information. 

re- search- reverse [unbound] 
re- search- reverse is identical to search- reverse except that the search string is a regular expression rather 
than an uninterpreted sequence of characters. See the section on searching, section 13 page 14 for more 
information. 

read- abbrev- file [unbound] 
Read in and define abbrcvs appearing in a named file. This file should have been written using wrile- 
abbrev-file. An error message is printed if the file cannot be found. 

read-file tXtR 
Prompt for the name of a file; erase the contents of the cui rent buffer; read the file into the buffer and 
associate the name with the buffer. Dot is set to the beginning of the buffer. 

recursion-depth [unbound] 
Returns the depth of nesting within recursive- ediCs. It returns 0 at the outermost level. 

recursive- edit [unbound] 

The recursive-edil function is a call on the keyboard read/intcrprct/execute routine. After recursive-edit is 
called the user can enter commands from the keyboard as usual, except that when he exits Emacs by calling 
exii-emacs (typing tC) it actually returns from tlic call to recursive-edil. This function is handy For packages 
that want to pop into some state, let the user do some editing, then when they're done perform some cleanup 
and let the user resume. For example, a mail system could use this for message composition. 
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redraw- display 

Clear the screen and rewrite it. This is useftil if some transmission glitch, or a message from a friend, has 
messed up the screen. 

region-around-malch [unbound] 
Region-around-Match sets dot and mark around the region matched by the last search. An argument of n 
puts dot and marie around the n[h subpattcm matched by 'M' and '\)'. This can then be used in conjuction 
with region-io-siring to extract fields matched by a patter. For example, consider the following fragment that 
extracts user names and host names from mail addresses: 

(re-search-forward "\\(Ca-z][;a-z]*\\) •\\([a-2][a-z]«\\)-) 

( reg ion-around-match 1) 

(setq username (region-to-string)) 

(region-around-match 2) 

(setq host (region-to-string)) 

Applying this MLisp code to the text "send it to jag(gvlsi" would set the variable 'username' to "jag" and 
'host' to "vlsi". 

region- lo-process [unbound] 
(region-to-process "process-name") ~ The region is wrapped up and sent to the process. 

region-to-slring [unbound] 
Returns the region between dot and mark as a string. Please be kind to the storage allocator, don't use 
huge strings. 

remove-all-hcal-bindings [unbound] 
Perform a remove-Iocai-binding for all possible keys; effectively undoes all local bindings. Mode packages 
should execute this to initialize the local binding table to a clean state. 

remove-binding [unbound] 
Removes the global binding of the given key. Actually, it just rcbinds the key to illegal-operalion. 

remove-local-binding [unbound] 
Removes the local binding of the given key. The global binding will subsequently be used when 
interpreting the key. Bug: there really should be some way of saving the current binding of a key, then 
restoring it later. 

replace- siring F>SC-R 
Replace all occurrences of one string for another, starting at dot and ending and tlie end of the buffer. 
Emacs prompts for an old and a new string in the minibuffer (the line at the bottom of the screen). Unlike 
query-rcplacc-string Emacs doesn't ask any questions about particular occurrences, it just changes diem. Dot 
will be left after the last changed string. See the section on searching, section 13 page 14 for more information 
on search strings. 
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return-prefix-argument [unbounilj 
(return-pref ix-argument n) sets the numeric prefix argument to be used by tJic next function 
invocation to n. The next function may be either the next fiinction in the normal flow of MLisp execution or 
the next function invoked from a keystroke. Return-prefix-arguinent is to be used by fimctions that are to be 
bound to keys and which are to provide a prefix argument for die next keyboard command. 



return- to- monitor t 
Recursivly invokes a new shell, allowing the user to enter normal shell commands and run other programs. 
Return to Emacs by exiting the shell; ie. by typing tD. 

save-excursion [unbound] 
(save-excursion expressions...) is an MLisp fimction that evaluates the given expressions and returns the 
value of the last expression evaluated. It is much like progn except that before any expressions are executed 
dot and the current buffer are "marked" (via tlie marker mechanism) then after the last expression is executed 
dot and the current buffer are reset to the marked values. ITiis properly takes into account all movements of 
dot and insertions and deletions that occur. Save-excursion is useful in MLisp functions where you want to go 
do something somewhere else in this or some other buffer but want to return to die same place when you're 
done; for example, inserting a tab at the beginning of the current line. 



save- restriction [unbound] 
Save- restriction is only useful to people writing MLisp programs. It is used to save the region restriction for 
the current buffer (and only the region restriction) during die execution of some subexpression that 
presumably uses region restrictions. The value of (save-excursion expressions . . . ) is the value of 
the last expression evaluated. 



save- window- excursion [unbound] 
save- window- excursion is identical to save-excursion except diat it also saves (in a rough sort of way) the 
state of the windows. That is, (save-windowexcursion expressions...) saves Lhc current dot, mark, buffer and 
window state, executes the expressions, restores the saved information and returns the value of the last 
expression evaluated. 

When the window state is saved Emacs remembers which buffers were visible. When it is restored, Emacs 
makes sure that exactly those buffers are visible. Emacs docs not save and restore the exact layout of the 
windows: this is a feature, not a bug. 



scroll-one-line-down ESC-Z 
Repositions the current window on the current buffer so tliat the line which is currently the second to the 
last line in the window becomes the last -- effectivly it moves die buffer down one line in die window. tZ is 
its inverse. 
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scrol!-one-liiie-up t2, 
Repositions the current window on the current buffer so tJiat Lhc line which is currently the second line in 
the window becomes the first -- effectivly it moves die buffer up one line in die window. ESC-Z is its inverse. 



search-forward tS 
Prompt for a string and search for a match in die current buffer, moving forwards from dot, stopping at die 
end of die bulTer. Dot is left at die end of die matched string if a match is found, or is unmoved if not. See 
die section on searching, section 13 page 14 for more information. 



search- reverse . tjj 

Prompt for a string and search for a match in die current buffer, moving backwards from dot, stopping at 
die beginning of die buffer. Dot is left at die beginning of die matched string if a match is found, or is 
unmoved if not. See die section on searching, section 13 page 14 for more information. 



self-insert [unbound] 
This is ued to diosc keys which are supposed to self-insert. It is roughly die same as 
(insert-character (last-key-struck)) widi die exception diat it doesn't work unless it is bound to a key. 



send- St ring- to- terminal [unbound j 

(send-string-to- terminal "string") sends die string argumetn out to die terminal with no conversion or 
inteipretation. This should only be used for such applications as loading fimction keys when Emacs starts up. 
If you screw up die screen, Emacs won't know about it and won't fix it up automatically for you - you'll have 
to type tL. 



[unbound] 

u.v. ...luv, juiiiv (uiiuuiv Liit<,tiiai lu i.,ivi/\t_j. j,iviA»_o Will dbiL lui uic iiduie ui a vuiiiiuii: ana a value to 
set it to. The variables control such diings as margins, display layout options, die behavior of search 
commands, and much more. The available variables and switches are described elsewhere. Note diat if set is 
used from MLisp die variable name must be a string: (set "left-margin" 77). 

set-mark t@ 
Puts die marker for diis buffer at die place where dot is now, and leaves it diere. As text is inserted or 
deleted around die mark, die mark will remain in place. Use rXtX to move to die currently marked position. 



[unbound] 

Assigns a new value to a variable. Variables may have cither string or integer values, (sctq i 5) sets i to 5; 
(sctq s (concat "a" "b")) sets s to "ab". 
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shrin k- wiiido w t X t Z 

Makes tlie currenc window one line siiortcr, and the window below (or the one above if there is no window 
below) one line taller. Can't be used if tliere is only one window on the screen. 

sit-for [unbound] 
Updates die display and pauses for n/10 seconds, (sit-for 10) waits for one second. This is usefiil in such 
things as a Lisp auto-paren balenccr. 

split- current- window tX2 
Enter two-window mode. Actually, it takes the current window and splits it into two windows, dividing the 
space on the screen equally between the two windows. An arbitrary number of windows can be created - the 
only limit is on the amount of space available on the screen, which, sigh, is only 24 lines on most terminals 
available these days (with the notable exception of the Ann Arbor Ambassador which has 60). 

starl-fdtered-process [unbound] 
(start- filtcred-proccss "command" "buffer-name" "on-output-procedurc") - Docs the same diing as start- 
process except that things are set up so that "on-output-procedure" is automatically called whenever output 
has been received from this process. This procedure can access the name of the process producing the output 
by rcfering to the variable MFX-process, and can retrieve the output itself by calling tlic procedure process- 
output. 

The filter procedure must be careful to avoid generating side-effects (eg. search- forward). 
Moreover, if it attempts to go to the terminal for information, output from other processes may be 
lost. 

start-process [unbound] 
(start-process "command" "buffer-name") ~ The home shell is used to start a process executing the 
command. This process is tied to the buffer "buffer-name" unless it is null in which case die "Command 
execution" buffer is used. Output from die process is automatically attached to the end of the buffer. Each 
dme Uiis is done, the mark is left at the end of die output (which is die end of die buffer). 

start- remembering tX( 
All following keystrokes will be remembered by Emacs. 

stop-process [unbound] 
(stop-process "process-name") -- Tell the priKess to stop by sending it a stop signal. Use continue- process 
to carry on. 
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stop- remembering 

Stops remembering keystrokes, as initiated by tX(. The remembered keystrokes are not forgotten and may 
be re^cXccutcd with f XE. 

Siring- to-char [unbound] 
Returns the integer value of the first character of its string argument, (string-to-char "0") = '0'. 

siring-lo-process [unbound] 
(strmg-to-process "process-name" "string") - The string is sent to the process. 



[unbound] 

(substr str pos n) reuirns Uie substring of string sir starting at position pos (numbering from 1) and amning 
for n characters. If pos is less than 0, then length of tlic string is added to it; the same is done for n. 
(substr "kzin" 2 2) = "zi"; (substr "blotto.c" -2 2) = ".c". 



switch' io-buffer ^^j^ 
Prompt for the name of the buffer and associate it with tlie current window. The old buffer associated with 
tills window merely loses that association: it is not erased or changed in any way. If the new buffer docs not 
exist, it will be created, in contrast with tXtO. 

system-name [unbound] 
Is an MLisp function that returns the name of the system on which EmacS is being run. This should be the 
ArpaNet or EtherNct (or whatever) host name of the machine. 



temp-use-bujfer [unbound] 

Switch to a named buffer wV/iou/ chaneine window 
to-buffer both cause a window to be tied to tlie selected buffer, temp-use-buffcr docs not. There are a couple 
of problems that you must beware when using this command: The keyboard command driver insists that tlic 
buffer tied to the current window be the current buffer, if it sees a difference then it changes the current 
buffer to be tlic one tied to Lhe current window. This means that tcmp-usc-buffer will be ineffective from the 
keyboard, swiich-to-buffer should be used instead. The other problem is that "dot" is really a rather fimny 
concept. There is a value of "dot" associated with each window, not with each bujfer. This is done so that 
there is a valid interpretation to having the same buffer visible in several windows. There is also a value of 
"dot" associated with the current buffer. When you switch to a buffer witli tcmp-use-buffcr. this "transient 
dot" is what gets used. So, if you switch to another buffer, then use temp-use-buffer to get back, "dot" will 
have been set to I. You can use save-excursion to remember your position. 
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to-col [unbound] 
(to-col n) is an MLisp function that insert tabs and spaces to move the following character to printing 
column n. 



transpose-characters tT 
Take tlic two characters preceding dot and exchange them. One of the most common errors for typists to 
make is transposing two letters, typing "hte" when "the" is meant. tT makes correcting these errors easy, 
especially if you can develop a "tT reflex". 



unVmk-file [-inbound] 
(unl ink-f He fn) attempts to unlink (remove) the file named fn. Itretums true if the unlink failed. 

use-abbrev- table [unbound] 
Sets the current local abbrev table to the one with the given name. Local abbrev tables are bufTcr specific 
and are usually set depending on the major mode. Several buffers may have the same local abbrev table. If 
either the selected abbrev table or the global abbrev table have had some abbrevs defined in them, abbrev- 
mode is turned on for the current buffer. 



use- global- map [unbound] 
(use-global-map "mapname") uses the named map to be used for the global interpretation of all key 
strokes, use-local-map is used to change the local interpretation of key strokes. See the section on keymaps, 14 
page 16, for more information. 



use-local-map [unbound] 
(use-local-map "mapname") uses the named map to be used for the local interpretation of all key strokes. 
use- global- map is used to change the global interpretation of key strokes. See the section on keymaps, 14 page 
16, for more information. 



use-old-bujfer . tXtO 

Prompt for the name of the buffer and associate it with the current window. The old buffer associated with 
this window merely loses that association: it is not erased or changed in any way. The buffer must already 
exist, in contrast with tXB. 



use-syntax-table [unbound] 
Associates the named syntax table with die current buffer. Sec the description of the modify-syntax-entry 
command for more information on syntax tables. 
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users-full- name [unbound] 
MLisp function that returns the users Ml name as a string. [Really, it returns the contents of the gccos field 
of the passwd entry for the current user, which is used on many systems for the users full name.] 

users-login-name [unbound] 
MLiSp function that returns the users login name as a string. 

mit-file tXtV 
Visit-file asks for the name of a file and switches to a buffer that contains it. The file name is expanded to 
it's fiill absolute form (that is, it will start with a 7*). If no buffer contains tiic file already then Emacs will 
switch to a new buffer and read the file into it. 'ITie name of this new buffer will be just tlic last component of 
the file name (everytliing after tlie last V in the name). If there is already a buffer by that name, and it 
contains some other file, then Emacs will ask "Enter a new buffer name or <CR> to overwrite the old buffer". 
For example, if my current directory is "/usr/jag/emacs" and I do a tXtV and give E.MACS the file name 
"../.emacs.pro"tlicn the name of the new buffer will be ".emacs.pro" and the file name will be 
"/usr/jag/.cmacs.pro". tXtV is the approved way of switching from one file to another within an invocation 
of Emacs. 

>^^'^^ , [unbound] 

(while test expressions...) is an MLisp fianction that executes the given expressions while the test is true. 

widen-region [unbound] 
The widen-region command sets the restriction to encompass the entire buffer. It is usualy used after a 
narroH'-region to restore Emacs's attention to the whole buffer. 

working-directory [unbound] 
Returns the patliname of the current working directory. 

write-abbrevfde [unbound] 
Write all defined abbrevs to a named file. This file is suitable for reading back with read-abbrevfde. 

wrile-currenl-fde tXtS 
Write the contents of the current buffer to the file whose name is associated with tlie buffer. 



wrile-fde-exil 

Write all modified buffers to their associated files and if all goes well, Emacs will exit. 



tXtF 
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wriie-iiiodifiecJ-files tXtM 
Write each modified buffer (as indicated by tXtB) onto the file whose name is associated with the buffer. 
Emacs will complain if a modified buffer does not have an associated file. 

write- named- file tXtW 
Prompt for a name; write the contents of the current buffer to the named file. 

yank-bujfer ESC-tY 
Take the contents of the buffer whose name is prompted for and insert it at dot in die current buffer. Dot 
is left after the inserted texL 

yank-from-killbuffer tY 
Take the contents of the kill buffer and inserts it at dot in the current buffer. Dot is left after the inserted 
text 

/ [unbound] 
(I e^ e^ MLisp fLmction that returns | e^. 



21 . Options 

Tliis chapter describes (in alpahbctical order) all of the variables which the user may set to configure 
Emacs to taste. 

ask-about-buffer-names 

The ask-about-buffer-names variable controls what the visit-file command docs if it detects a collision when 
constaicting a buffer name. If ask-about-buffer-names is true (the default) then Rmacs will ask for a new 
buffer name to be given, or for <CR> to be typed which will overwrite the old buffer. If it is false then a 
buffer name will be synthesized by appending "</z>" to die buffer name, for a unique value of n. For 
example, if I visit-file "makefile" Uien the buffer name will be "makefile"; tlicn if I visit-file "man/makefile" 
the buffer name will be "makefile<2>". 

backup-by-copying 

If true, then when a backup of a file is made (see the section on tlie backup-before-writing variable) then 
rather dian doing the fancy link/unlink footwork, Emacs copies the original file onto tiic backup. This 
preserves all link and owner information & ensures that die files 1-number doesn't change (you're crazy if you 
worry about a files 1-numbcr). liackup-by-copying incurs a fairly hcafty performance penalty. See Uic section 
on the backup-by-copying-when-linkcd variable for a description of a compromise, (default OFF) 
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backup-by-copying-when-Unked 

If tnie. tlicn when a barlriin nf ,n flip k rmHo (caa t\^n c^^cv.,, tUr, u-c-^-j. -r.r„. ■ • ■ 

the link count of the file is greater than 1, rather than doing the fancy link/unlink footwork, Emacs copies the 
original file onto the backup. If the link count is 1, Uicn the link/unlink trick is pulled. This preserves link 
information when it is important, but still manages reasonable performance the rest of the time. Sec the 
section on the backup-by-copying variable for a description of a how to have owner & I-numbcr infonnation 
preserved, (default OFF) 

backup- when- writing 

If ON Emacs will make a backup of a file just before the first time Uiat it is overwritten. The backup will 
have the same name as the original, except that the string ".BAK" will be appended; unless tlic last name in 
the path has more than 10 characters, in which case it will be truncated to 10 characters, "foo.c" gets backed 
up on "foo.c.BAK"; "Aisr/jag/foo.c" on Vusr/jag/foo.c.BAK"; and "EtherScrvicc.c" on "EtherServi.BAK". 
The backup will only be made the first time that the file is rewritten from within Uie same invocation of 
Emacs. so if you write out the file several times the .BAK file will contain the file as it was before Emacs was 
invoked. The backup is normally made by fancy footwork with links and unlinks, to achieve acceptable 
performance: when "foo.c" is to be rewritten, Emacs effectivly executes a "mv foo.c foo.c.BAK" and then 
creates foo.c a write the new copy. The file protection of foo.c is copied from tlie old foo.c, but old links to 
the file now point to the .BAK file, and Uic owner of the new file is the person amning Emacs. If you don't 
like this behaviour, see the switches backup-by-copying and backup-by-copying-when-linkcd. (default OFF) 

bujfer-is-modified 

Buffcr-is-modified is tmc iff the current buffer has been modified since it was last written out. You may 
set if OFF (ie. to 0) if you want Emacs to ignore die mods tliat have been made to this buffer -- it doesn't get 
you back to the unmodified version, it just tells Emacs not to write it out with the other modified files. 
Emacs sets buffer-is-modificd true any time the buffer is modified. 

case-fold-search 

If set ON all searches will ignore the case of alphabetics when doing comparisons, (default OFF) 
checkpoint-frequency 

The number of keystrokes between checkpoints. Every "checkpoint-frequency" keystrokes all buffers 
which have been modified since they were last checkpointed arc written to a file named "fde.CK?". File is 
the file name associated with the buffer, or if that is null, the name of tJie buffer. Proper account is taken of 
the restriction on file names to 14 characters, (default 300) 

comment-column 

The column at which comments arc to start. Used by the language-dependent commenting features 
through the move-lo-comment-column command, (default 33) 
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cllchar- with- 1 

If set ON control characters are printed as tC (an 't' character followed by the upper case alphabetic tliat 
corresponds to the control character), otherwise they are printed according to the usual Unix convention ('V 
followed by a three digit octal number), (default OFF) 

default-case-fold-search 

Default-case-fold-search provides the default value for case- fold- search, which is used whenever a new 
buffer is created, (default OFF) 

default-comment-column 

Default-comment-column provides the default value for comment-column, which is used whenever a new 
buffer is created. Its initial value is 33. 

defaull-left-margin 

Default-left-margin provides the default value for left-margin, which is used whenever a new buffer is 
created, (default 1) 

default-mode-line-format 
This is the value given to mode-line-formal when a buffer is created. 

default- right- margin 

Default- right-margin provides tlic default value for right-margin, which is used whenever a new buffer is 
created. Its initial value is some very large number. 

default- tab-size 

This is the value given to tab-size when a buffer is created, (default 8). 

files-should-end-with-newline 

Indicates that when a buffer is written to a file, and the buffer doesn't end in a newline, then the user 
should be asked if they want to have a newline appended. It used to be that this was the default action, but 
some people objected to the question being asked, (default ON) 

global- mode- string 

Global-mode-string is a global variable used in the constaiction of mode lines see section 16, page 18 for 
more information. 
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help-oti-cominaiid-complelion 

If ON Emacs will print a list of possibilities when an ambiguous command is given, otherwise it just rings 
the bell and waits for you to type more, (default ON) 

left-margin 

The left margin for automatic text justification. After an automatically generated newUne the new line will 
be indented to die left margin. 

mode- line- formal 

mode- line-formal is a buffer specific variable used to specify the format of a mode line. Sec section 16, page 
18 for more infonnation. 

mode-siring 

Mode-siring is a buffer specific variable used in the constRiction of mode lines see section 16, page 18 for 
more information. 

needs-checkpoinling 

A buffer-specific variable which if ON indicates that the buffer should be checkpointcd periodically. If it is 
OFF, then no checkpoints will be done, (default ON) 

pop-up-windows 

If ON Emacs will try to use some window other tlian the current one when it spontaneously generates a 
buffer that it wants you to see or when you visit a file (it may split the current window). If OFF the current 
window is always used, (default ON) 

prefix- argument 

Evei7 fijnction invocation is always prefixed by a numeric argument, either explicitly with tU/( or provide- 
prefix-arg'umcnt. The value of the variable prefix-argument is the argument prefixed to tlic invocation of the 
current MLisp function. For example, if die following function: 
(defun 

(show-it 

(message (concat "The prefix argument is " prefix-argument)) 

) 

were bound to the key tA then typing tUtA would cause the message "The prefix argument is 4" to be 
printed, and tU13tA would print "The prefix argument is 13". Sec also the commands prcfix-argument-Ioop 
and providc-prefix-argumcnt. 
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prefix- argument- provided 

Tnie iff the execution of the current function was prefixed by a numeric argument. Use prefix-argumeiu to 
get it's value. 

prefix-siring 

The string that is inserted after an automatic newline has been generated in response to going past the right 
margin. Tills is generally used by the language-dependent commenting features, (default "") 

quick- redisplay 

If ON EmacS won't worry so much about the case where you have tlie same buffer on view -i several 
windows -- it may let the other windows be inaccurate for a short while (but they will eventually be fixed up). 
Turning this ON speeds up EmacS substantially when the same buffer is on view in several windows. When 
it is OFF, all windows are always accurate, (default OFF) 

replace- case 

If ON Emacs will alter the case of strings substituted with replace- string or query- replace- string to match 
the case of the original string. For example, replacing "which" by "that" in the string "Which is silly" results 
in "That is silly"; in the string "Uie car which is red" results in "tlie car that is red"; and in the string 
"WHICH THING?" results in "THAT THING?". 

right-margin 

The right margin for automatic text justification. If a character is inserted at the end of a line and to the 
right of the right margin EmaCS will automatically insert at the beginning .of the preceding word a newline, 
tabs and spaces to indent to the left margin, and ilie prefix string. With tlie right margin set to something like 
(for eg.) 72 you can type in a document without worrying about when to hit tlie retuni. key, EmacS will 
automatically do it for you at exactly the right place. 

scroll-step 

The number of lines by which windows arc scrolled if dot moves outside the window. If dot has moved 
more tlian scroll-step lines outside of tlic window or scroll-step is zero then dot is centered in the window. 
Otherwise the window is moved up or down scroll-step lines. Setting scroll-step to 1 will cause the window to 
scroll by 1 line if you're typing at the end of the window and hit REFURN. 

silen tly- kill- processes 

If ON Emacs will kill processes when it exits without asking any questions. Normally, if you have 
processes running when E.MACS exits, the question "You have processes on the prowl, should 1 hunt tlicm 
down for you" is asked, (default OFF) 
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stack- trace- on- error 

If ON Emacs will write a MLisp stack t_racc to Lhe "Stack U'ace" buffer whenever an error is encountered 
from within an MLisp ftinction (even inside an error-occured). This is all there is in the way of a debugging 
facility, (default OFF) 



tab-size 

A buffer-specific variable which specifies the number of characters between tab stops. It's not clear that 
user specifiable tabs are a good idea, since the rest of Unix and most other DEC styled operating systems have 
the magic number 8 so deeply wired into them., (default 8) 



this- command 



The meaning of the variable this- command \s tightly intertwined with the meaning of the function previous- 
command. Look at its documentation for a description of this-command. 



track-eol-on-tN-tP 

If ON then tN and tP will "stick" to the end of a line if they arc started there. If OFF tN and tP will try 
to stay in the same column as you move up and down even if you started at the end of a line, (default ON) 

unlink-checkpoint-fdes 

If ON E.MACS will unlink the corresponding checkpoint file after tlie master copy is written -- tliis avoids 
having a lot of .CKP files lying around but it does compromise safety a little. For example, as you're editing a 
file called "foo.c" Emacs will be periodically be writing a checkpoint file called "foo.c.CKP" that contains all 
of your recent changes. When you rewrite the file (with tXtF or tXtS for example) if unlink-chcckpoint- 
filcs is ON then die .CKP file will be unlinked, otherwise it will be left, (default OFF) 

visihl c~ h cl I 

If ON Emacs will attempt to use a visible bell, usually a horrendous flashing of the screen, instead of the 
audible boll, when it is notifying you of some error. This is a more "socially acceptable" technique when 
people arc working in a crowded terminal room, (default OFF) 

wrap-long-lines 

If ON Emacs will display long lines by "wrapping" their continuation onto the next line (the first line will 
be terminated with a 'V). If OFF long lines get truncated at the right edge of die screen and a '$' is display to 
indicate that this has happened, (default OFF) 



22. 


Command summary 




Key 


BindinR 


tF 


t@ 


set-mark 


tG 


tA 


bcginning-of-linc 


tH 


tB 


backward-character 


tl 


tC 


exit-emacs 


tj 


tD 


delete- nc.it-character 


tK 


tE 


cnd-of-linc 


tL 



forward-character 

illegal-operation 

delcte-previous-charactcr 

self-insert 

ncwilnc-and-indent 

kill-lo-cnd-of-linc 

rcdraw-display 
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ncwiinc 


tN 


next-line 


to 


newline-and-backup 


tP 


previous-line 


tQ 


quote-character 


tR 


search-reverse 


tS 


search- forward 


tT 


transpose-characters 


tU 


argument-prefix 


TV 


next-page 


tW 


delete-to-killbuffer 


tX 


tX-prefix 


tX-tB 


list-bufTers 


tXtC 


exil-cmacs 


tX-tD 


describe-word-in-bufTer 


tX-tE 


compile-it 


tX-tF 


write-file-exit 


tXtl 


insert- file 


tX-tM 


write-modified-files 


tX-tN 


next-error 


tXtO 


usc-old-buffer 


tX-tR 


read-file 


tX-tS 


write-current-file 


tX-tV 


visit-file 


tX-tW 


write- named- file 


tX-tX 


exchange-dot-and-marlc 


tXtZ 


shrink-window 


tX-! 


execute-monitor-command 


tX-( 


start-remembering 


tX) 


stop-remembering 


tX-1 


delcte-otlicr-windows 


tX-2 


splil-current-window 


tX-b 


switch-to-bufTer 


tX-d 


delete-window 


tXc 


execute-keyboard-macro 


tX-ra 


small 


tX-n 


next-window 


tX-p 


previous-window 


tX-r 


rmail 


tX-7. 


enlarge-window 


tY 


yank-from-killbufFer 


tZ 


scroll-one-line-up 


ESC 


ESC-prefix 


ESC-tC 


exit-emacs 


ESC-tV 


page-next-window 


ESCtW 


delete- region-to- bu ffer 


ESCtY 


yank- buffer 


ESCI'ISC 


executc-mlisp-line ■ 


ESC-tt 


case- region-invert 


ESC-! 


linc-to-iop-of-window 


VSC; 


bcginning-of- window 


ESC" 


meta-minus 


ESO. 


end-of-window 


ESC-0..ESC-9 meta-digit 


ESC-< 


beginning-of-file 


ESC-> 


end-of-file 


ESC? 


apropos 


ESC-l 


backward-paragraph 


ESC-] 


forward-paragraph 


ESCt 


case-word-invert 



use- a 


backward-sciilence 


ESCb 


backward-word 


ESC-d 


delete-next-word 


ESC-e 


forward-sentence 


ESC-f 


forward- word 


ESC-h 


dclete-previous-word 


ESC-j 


indent-C-proccdure 


ESCl 


case- word- lower 


ESC-q 


query-repiacc-string 


ESC-r 


replace-string 


ESC-u 


case-word-upper 


ESC-v 


previous-page 


ESC-x 


exccute-extcnded-command 


ESC-z 


scroll-one-line-down 


t— 


retum-to-monitor 




self-insert 




minus 




self-insert 


0..9 


digit 




self-insert 


t? 


delete-previous-character 
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